API Reference / Intents
List contract intents in a snapshot
Returns a paged list of intents produced by one contract evaluation snapshot, ordered by the requested sort field and direction with the intent id as a stable tiebreak. Each page carries hydrated entities, so no follow-up GetIntents is needed.
/ contracts. v1. Contracts/ ListIntentsRequest body
application/jsonRequired
Request for one page of the intents produced by one contract snapshot.
contractIdstringContract to list intents from.
Format"byte" base64
cursor?stringOpaque pagination cursor from a previous ListIntentsResponse. Empty for the first page.
descending?booleanOrder descending instead of ascending. Start a new cursor when changing the field or direction.
limit?integerMaximum number of intents to return. Server caps this at a service-defined upper bound.
Format"int32"
snapshotIdstringEvaluation snapshot to list intents from.
Format"int64"
sortField?stringField to order the page by, with the intent id as a stable tiebreak. Unspecified orders by creation time.
Value in"INTENT_"INTENT_"INTENT_"INTENT_
Response body
application/json
Success
intents?array<Intent>Full intents for this page. A page carries the hydrated entities, not bare ids, so the caller needs no follow-up GetIntents.
Show attributes
contractId?stringContract that produced this intent.
Format"byte" base64
createdAt?stringWhen this version of the intent was created: the creation time of the snapshot that introduced it.
Format"date-time"
createdBy?stringActor whose contract update triggered the evaluation that produced this intent. Unset for a background evaluation (a periodic re-evaluation sweep, or a SERVICE own-behalf actor).
Format"byte" base64
deletedAt?stringWhen the intent was soft-deleted, if it has been.
Format"date-time"
id?stringOpaque 16-byte identifier of this version of the intent, base64-encoded in JSON. An intent keeps the same identifier across every consecutive snapshot in which its price and float window are unchanged, and gets a new one when they change. Exists only for API addressability. The intent's business identity within a snapshot is (contract, snapshot, market_hash_name).
Format"byte" base64
marketHashName?stringThe item this intent matched, for example "AK-47 | Redline (Field-Tested)".
maxBuyPriceCents?stringThe price this intent will pay (a buying contract) or list at (a selling contract), computed by the contract's valuation.
Format"int64"
maxFloat?numberPredicate float window upper bound. 1.0 means no upper bound.
Format"double"
minFloat?numberPredicate float window lower bound. 0.0 means no lower bound.
Format"double"
referencePrices?array<ReferencePrice>Per-reference price breakdown behind max_buy_price_cents, pinning each valuation reference's resolved source price at the snapshot that introduced this version of the intent. A later evaluation whose only change is the breakdown keeps the intent unchanged.
Show attributes
lastObservedAt?stringFor a stale reference, when last_value_cents was observed. Set only when outcome is stale.
Format"date-time"
lastValueCents?stringFor a stale reference, the last value the source reported before the reference's adjustment, in US cents. Set only when outcome is stale.
Format"int64"
metric?stringThe metric read for a market data lookup. Absent for a sale computation.
observedAt?stringWhen the figure behind value_cents was observed: the market observation's own time for a market data lookup, or the newest sale in the window for a sale computation. Absent when value_cents is absent.
Format"date-time"
outcome?stringWhether the reference resolved a price, found only an observation older than its freshness window, or found no data at all.
Value in"REFERENCE_"REFERENCE_"REFERENCE_
priceCents?stringThe price after the reference's adjustment, in US cents, which the valuation strategy combines. Absent when the source had no usable data.
Format"int64"
referenceIndex?integerZero-based position of the reference in the valuation's references.
Format"int32"
source?stringThe reference's market source, such as "market-csgo".
valueCents?stringThe price the source gave before the reference's adjustment, in US cents. Absent when the source had no usable data.
Format"int64"
snapshotId?stringEvaluation snapshot this intent was read in: the snapshot the request named. A GetIntents call with no snapshot reports the snapshot that introduced this version of the intent.
Format"int64"
updatedAt?stringWhen the intent was last modified.
Format"date-time"
updatedBy?stringSame actor as created_by. An intent is insert-only, so the two are always stamped identically.
Format"byte" base64
nextCursor?stringCursor to pass to fetch the next page. Empty when there are no more results.
application/json
The request was malformed, such as a missing required field or an unparseable cursor.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request lacks a valid API key in the Authorization header.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The API key is not allowed to perform this action on this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request was rate limited. Slow down and retry later.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
An internal server error occurred.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/ListIntents" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"snapshotId": "7",
"limit": 100,
"cursor": ""
}'const res = await fetch("https://api.goldmine.to/contracts.v1.Contracts/ListIntents", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"snapshotId": "7",
"limit": 100,
"cursor": ""
}),
});
const data = await res.json();body := strings.NewReader(`{
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"snapshotId": "7",
"limit": 100,
"cursor": ""
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/contracts.v1.Contracts/ListIntents", body)
if err != nil {
return err
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("CSTRADER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)import os, requests
res = requests.post(
"https://api.goldmine.to/contracts.v1.Contracts/ListIntents",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"snapshotId": "7",
"limit": 100,
"cursor": ""
},
)
data = res.json(){
"intents": [
{
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"snapshotId": "7",
"id": "aW50ZW50LWl0ZW0tMDAwMQ==",
"marketHashName": "AK-47 | Redline (Field-Tested)",
"maxBuyPriceCents": "4800",
"maxFloat": 0.38,
"referencePrices": [
{
"referenceIndex": 0,
"source": "buff163",
"metric": "sell_min",
"valueCents": "5000",
"priceCents": "4800"
}
],
"createdAt": "2026-04-01T12:15:00Z",
"updatedAt": "2026-04-01T12:15:00Z"
}
],
"nextCursor": ""
}{
"code": "invalid_argument",
"message": "The request was malformed, such as a missing required field or an unparseable cursor."
}{
"code": "unauthenticated",
"message": "The request lacks a valid API key in the Authorization header."
}{
"code": "permission_denied",
"message": "The API key is not allowed to perform this action on this workspace."
}{
"code": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}