API Reference / Intents
Fetch a single contract intent by ID
Returns one evaluated buying or selling intent within a contract snapshot. An intent records the item, the float window, and the price the contract will pay or list at, along with the source prices behind it.
/ contracts. v1. Contracts/ GetIntentRequest body
application/jsonRequired
Request for one intent in a contract snapshot by identifier.
contractIdstringContract the intent belongs to.
Format"byte" base64
intentIdstringIntent identifier.
Format"byte" base64
snapshotIdstringEvaluation snapshot the intent belongs to.
Format"int64"
Response body
application/json
Success
intent?IntentThe requested intent.
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
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 requested resource does not exist in 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/GetIntent" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"snapshotId": "7",
"intentId": "aW50ZW50LWl0ZW0tMDAwMQ=="
}'const res = await fetch("https://api.goldmine.to/contracts.v1.Contracts/GetIntent", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"snapshotId": "7",
"intentId": "aW50ZW50LWl0ZW0tMDAwMQ=="
}),
});
const data = await res.json();body := strings.NewReader(`{
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"snapshotId": "7",
"intentId": "aW50ZW50LWl0ZW0tMDAwMQ=="
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/contracts.v1.Contracts/GetIntent", 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/GetIntent",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"snapshotId": "7",
"intentId": "aW50ZW50LWl0ZW0tMDAwMQ=="
},
)
data = res.json(){
"intent": {
"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"
}
}{
"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": "not_found",
"message": "The requested resource does not exist in this workspace."
}{
"code": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}