API Reference / Purchases
Fetch a single purchase by ID
Returns the purchase identified by purchase_id within the caller's active workspace. Purchases track an item acquisition from attribution through marketplace completion and Steam trade.
/ contracts. v1. Contracts/ GetPurchaseRequest body
application/jsonRequired
Request for one purchase in the caller's workspace by identifier.
purchaseIdstringPurchase identifier.
Format"byte" base64
Response body
application/json
Success
purchase?PurchaseThe requested purchase.
Show attributes
accountAttempts?array<PurchaseAccountAttempt>The buying accounts tried, in order, for a failed purchase. Empty when none were reported.
Show attributes
accountName?stringThe account that was tried.
attemptedAt?stringWhen the attempt was made.
Format"date-time"
detail?stringA plain sentence describing the failure. Never names a credential.
reason?stringWhy this account's attempt failed.
Value in"PURCHASE_"PURCHASE_"PURCHASE_"PURCHASE_"PURCHASE_"PURCHASE_
accountName?stringSteam/marketplace account that executed the buy.
afterStopFlaggedAt?stringSet when this purchase was recorded while buying was stopped.
Format"date-time"
buyingOrigin?BuyingOriginWhose switches had the market and the way of buying on when the buy was committed. Unset on a purchase recorded before this was kept.
Show attributes
marketOnBy?stringWhose switch had the market on: WORKSPACE or CONTRACT.
Value in"BUYING_"BUYING_"BUYING_
wayOnBy?stringWhose switch had the way of buying on: DEFAULT, WORKSPACE or CONTRACT.
Value in"BUYING_"BUYING_"BUYING_
chargedAmount?stringThe amount the market charged, in that currency.
chargedCurrency?stringThe currency the market charged in.
contractId?stringContract that matched and won attribution for this purchase.
Format"byte" base64
contractVersion?stringThe contract's version when the buy was committed, from the snapshot it was bought under. Unset when no snapshot is known.
Format"int64"
createdAt?stringWhen the purchase was attributed.
Format"date-time"
createdBy?stringActor whose contract evaluation produced the winning intent this purchase was recorded against. Unset when the intent traces back to a background evaluation (a periodic re-evaluation sweep, or a SERVICE own-behalf actor), or when the winning active intent was withdrawn before this purchase could read it.
Format"byte" base64
custody?PurchaseCustodySet while the market that sold the item holds it until it is withdrawn to the receiving Steam account. The item is owned and not yet received.
Show attributes
heldSince?stringWhen the purchase was recorded as held at the market.
Format"date-time"
market?stringThe market holding the item.
transferId?stringThe market's reference of the withdrawal. Empty until it is asked for.
withdrawableAt?stringWhen the market lets the item be withdrawn: its trade lock's end. Unset when it can be withdrawn now.
Format"date-time"
withdrawalRequestedAt?stringWhen the withdrawal to Steam was asked for. Unset while the item still waits at the market.
Format"date-time"
deletedAt?stringWhen the purchase was soft-deleted. Unset for active purchases.
Format"date-time"
deliveredAt?stringWhen the bought item arrived in the workspace's Steam inventory. Unset until delivered.
Format"date-time"
deliveryAccountName?stringThe Steam account that received the delivery trade offer.
deliveryDeadline?stringWhen an undelivered purchase is flagged as late.
Format"date-time"
deliveryOfferCreatedAt?stringWhen the delivery trade offer was created on Steam.
Format"date-time"
deliveryStatus?stringCustomer-facing state: pending, delivered or failed. Failed means rolled back after the buy.
Value in"PURCHASE_"PURCHASE_"PURCHASE_
deliveryTradeCompletedAt?stringWhen Steam completed the trade that delivered this purchase, from Steam's own record of the trade. Unset while Steam's time is not known, never filled with the time it was noticed or reported.
Format"date-time"
deliveryTradeOfferId?stringThe Steam trade offer that delivered this purchase, bound by an exact asset id match when the delivery entered escrow or was received. Unset until then.
escrowEndDate?stringThe escrow hold's expected release date, when Steam reports one. Unset when Steam withheld the ETA, or when the delivery was never escrowed.
Format"date-time"
escrowedAt?stringWhen the delivery was first observed in escrow. Unset when the delivery was never held.
Format"date-time"
evaluatedAt?stringWhen the winning contract was last evaluated before the buy, read at assignment. With each reference price's observed_at it says how old the figures were and that they were still current at that evaluation. Unset for purchases recorded before it was stored.
Format"date-time"
expectedDeliveryAccountName?stringThe Steam account that receives the item.
expectedDeliveryAssetIds?array<string>The Steam asset ids the delivery offer must give.
expectedDeliveryOfferId?stringThe newest Steam offer id the market named for the delivery.
failedAt?stringWhen the purchase reached a terminal failure - failed or rolled_back. Unset for a purchase that has not failed.
Format"date-time"
failureDetail?stringA plain sentence about the failure. Unset when none was reported.
failureReason?stringWhy the purchase failed: the last account attempt's reason. Unset unless the purchase failed or was rolled back with a reported reason.
Value in"PURCHASE_"PURCHASE_"PURCHASE_"PURCHASE_"PURCHASE_"PURCHASE_
flaggedForReviewAt?stringWhen the stale-purchase reconciliation first flagged this purchase for manual review, having found it stuck past its delivery deadline. A durable, stamp-once audit fact. Unset until flagged and never erased. The live needs-review set is the flagged purchases whose inventory item is still pending_trade.
Format"date-time"
floatValue?numberThe bought item's real Steam float value, recorded at assignment. Unset when no real float was recorded, distinct from a 0.0 wear.
Format"double"
heldAtBuy?stringCopies of the item the workspace held when the purchase was recorded, not counting this purchase: the count the contract's keep limit (max_owned_per_item) is checked against, read in the same transaction that recorded the purchase. Set by GetPurchase and GetPurchases only. List reads leave it unset. Unset on a purchase recorded before this was kept.
Format"int64"
id?stringOpaque 16-byte purchase identifier.
Format"byte" base64
listingAssetId?stringSteam asset ID recorded on the marketplace listing at purchase time.
listingConflictFlaggedAt?stringSet when another purchase already held the same listing id on this market.
Format"date-time"
listingId?stringMarketplace listing identifier the item was purchased from.
listingPriceCents?stringActual listing price paid on the marketplace, in cents.
Format"int64"
listingPriceMicros?stringThe dollar price paid, in millionths of a dollar: charged_amount exactly when the market charged in dollars, else listing_price_cents. listing_price_cents is the same price rounded up to a cent, kept for limits. Show and sum this field.
Format"int64"
marketHashName?stringCanonical Steam market_hash_name of the item being purchased.
marketReadings?array<PurchaseMarketReading>The market data figures the contract's market data rules read for the bought item, taken when the purchase was recorded, one per market data rule of the recorded configuration. Set by GetPurchase and GetPurchases only. List reads leave it empty. Empty when the contract has no market data rule, until the figures are read (seconds after the record), and on a purchase recorded before this was kept.
Show attributes
figure?numberThe figure read, in US dollars for a price and as reported otherwise. Unset when no figure was fresh enough, which the rule counts as not met.
Format"double"
met?booleanWhether the rule held for that figure. Unset when it could not be judged.
metric?stringThe metric of that source the rule reads, as the rule names it.
path?stringThe rule's position in the recorded predicate: its child indexes from the root joined by dots, as GetPurchaseConfiguration returns the predicate.
readAt?stringWhen the figure was read.
Format"date-time"
source?stringThe market data source the rule reads.
marketplace?stringSource marketplace slug.
maxBuyPriceCents?stringMaximum price the contract was willing to pay at attribution time, in cents.
Format"int64"
maxFloat?numberUpper bound of the winning contract's float window the purchase was committed against. 1.0 means no upper bound. Unset for purchases recorded before the window was stored.
Format"double"
minFloat?numberLower bound of the winning contract's float window the purchase was committed against. 0.0 means no lower bound. Unset for purchases recorded before the window was stored.
Format"double"
moneyHoldDeadline?stringWhen the held money is expected to be final.
Format"date-time"
moneyHoldReason?stringThe market's own stage or waiting reason while the money is held.
moneyState?stringWhether the market still holds the money, has made it final, or has returned it.
Value in"PURCHASE_"PURCHASE_"PURCHASE_"PURCHASE_
overCeilingFlaggedAt?stringWhen this purchase was recorded with a listing price above the winning intent's committed max price - a market-service bug that overpaid, making platform_fee_cents negative. Stamped once at record time inside AssignPurchase and never erased. A permanent needs-review contributor that does not self-clear as the item delivers, because a negative-fee loss stays visible through to manual resolution.
Format"date-time"
overLimitFlaggedAt?stringSet when this purchase took its contract past a limit.
Format"date-time"
paidMismatchFlaggedAt?stringSet when the market's paid figure differs from the price that was sent.
Format"date-time"
paintSeed?integerThe bought item's pattern index (paint seed, 0 to 1000), from the listing at assignment or decoded from the delivered item's inspect link. Unset when unknown, distinct from seed 0.
Format"int32"
platformFeeCents?stringPlatform fee (max_buy_price - listing_price), in cents.
Format"int64"
positionId?stringThe position this purchase was recorded against, when a market worker recorded it.
Format"byte" base64
purchasedAt?stringWhen the purchase transitioned to completed - the buy executed and funds were committed. Unset while pending.
Format"date-time"
referencePrices?array<ReferencePrice>Per-reference price breakdown of the winning intent behind max_buy_price_cents, so the purchase price is traceable to the exact source figures behind it.
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"
revivedAt?stringSet when this purchase was recorded after its reservation had been closed or had passed its deadline.
Format"date-time"
snapshotId?stringThe evaluation snapshot whose intent the purchase was committed against, readable with GetSnapshot. Unset for purchases recorded before the snapshot was stored.
Format"int64"
status?stringCurrent purchase lifecycle state.
Value in"PURCHASE_"PURCHASE_"PURCHASE_"PURCHASE_"PURCHASE_"PURCHASE_
strategy?stringBuying mechanism that produced the purchase, recorded as provenance.
Value in"PURCHASE_"PURCHASE_"PURCHASE_"PURCHASE_
tradedAt?stringWhen the Steam trade completed and the item was received. Unset until traded.
Format"date-time"
updatedAt?stringWhen the purchase was last modified.
Format"date-time"
updatedBy?stringSame actor as created_by. Stamped once at record time and never revised by a later status transition.
Format"byte" base64
version?stringOptimistic concurrency version. Incremented on every status change.
Format"int64"
workspaceId?stringWorkspace the purchase belongs to.
Format"byte" base64
wrongFloatFlaggedAt?stringWhen this purchase was recorded with a float outside the winning intent's committed float window - a market-service bug that bought the wrong item. Stamped once at record time inside AssignPurchase and never erased. A permanent needs-review contributor that does not self-clear as the item delivers, because a wrong-item buy stays visible through to manual resolution.
Format"date-time"
wrongItemFlaggedAt?stringSet when the market returned or shows another item than the one bought.
Format"date-time"
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/GetPurchase" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"purchaseId": "MDEyMzQ1Njc4OWFiY2RlZg=="
}'const res = await fetch("https://api.goldmine.to/contracts.v1.Contracts/GetPurchase", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"purchaseId": "MDEyMzQ1Njc4OWFiY2RlZg=="
}),
});
const data = await res.json();body := strings.NewReader(`{
"purchaseId": "MDEyMzQ1Njc4OWFiY2RlZg=="
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/contracts.v1.Contracts/GetPurchase", 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/GetPurchase",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"purchaseId": "MDEyMzQ1Njc4OWFiY2RlZg=="
},
)
data = res.json(){
"purchase": {
"id": "MDEyMzQ1Njc4OWFiY2RlZg==",
"workspaceId": "AAECAwQFBgcICQoLDA0ODw==",
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"marketHashName": "AK-47 | Redline (Field-Tested)",
"status": "PURCHASE_STATUS_TRADED",
"version": "5",
"listingPriceCents": "4200",
"maxBuyPriceCents": "5000",
"platformFeeCents": "800",
"listingId": "csfloat-listing-8731",
"listingAssetId": "29384710293",
"marketplace": "csfloat",
"accountName": "trader_steam_01",
"createdAt": "2026-04-10T08:30:00Z",
"updatedAt": "2026-04-10T09:12: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."
}curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/GetPurchase" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"purchaseId": "X049LBsKmYh3ZlVEMyIRAA=="
}'const res = await fetch("https://api.goldmine.to/contracts.v1.Contracts/GetPurchase", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"purchaseId": "X049LBsKmYh3ZlVEMyIRAA=="
}),
});
const data = await res.json();body := strings.NewReader(`{
"purchaseId": "X049LBsKmYh3ZlVEMyIRAA=="
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/contracts.v1.Contracts/GetPurchase", 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/GetPurchase",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"purchaseId": "X049LBsKmYh3ZlVEMyIRAA=="
},
)
data = res.json(){
"purchase": {
"id": "X049LBsKmYh3ZlVEMyIRAA==",
"workspaceId": "AAECAwQFBgcICQoLDA0ODw==",
"contractId": "yv66vt6tvu8BAgMEBQYHCA==",
"marketHashName": "M4A1-S | Hyper Beast (Minimal Wear)",
"status": "PURCHASE_STATUS_TRADES_PENDING",
"version": "3",
"listingPriceCents": "3175",
"maxBuyPriceCents": "3500",
"platformFeeCents": "325",
"listingId": "csfloat-listing-90021",
"listingAssetId": "41028573662",
"marketplace": "csfloat",
"strategy": "assignment",
"accountName": "trader_steam_03",
"createdAt": "2026-06-18T11:20:00Z",
"updatedAt": "2026-06-20T03:00:00Z",
"flaggedForReviewAt": "2026-06-21T00: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."
}curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/GetPurchase" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"purchaseId": "obLD1OX2BxgpOktcbX6PkA=="
}'const res = await fetch("https://api.goldmine.to/contracts.v1.Contracts/GetPurchase", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"purchaseId": "obLD1OX2BxgpOktcbX6PkA=="
}),
});
const data = await res.json();body := strings.NewReader(`{
"purchaseId": "obLD1OX2BxgpOktcbX6PkA=="
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/contracts.v1.Contracts/GetPurchase", 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/GetPurchase",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"purchaseId": "obLD1OX2BxgpOktcbX6PkA=="
},
)
data = res.json(){
"purchase": {
"id": "obLD1OX2BxgpOktcbX6PkA==",
"workspaceId": "AAECAwQFBgcICQoLDA0ODw==",
"contractId": "ABEiM0RVZneImaq7zN3u/w==",
"marketHashName": "AWP | Asiimov (Field-Tested)",
"status": "PURCHASE_STATUS_PENDING",
"version": "1",
"listingPriceCents": "8650",
"maxBuyPriceCents": "9200",
"platformFeeCents": "550",
"referencePrices": [
{
"referenceIndex": 0,
"source": "market-csgo",
"metric": "safe_price",
"valueCents": "9000",
"priceCents": "8730"
},
{
"referenceIndex": 1,
"source": "steam-market",
"metric": "median_price",
"valueCents": "9500",
"priceCents": "9200"
}
],
"listingId": "csfloat-listing-44219",
"listingAssetId": "38172645091",
"marketplace": "csfloat",
"strategy": "buy_order",
"accountName": "trader_steam_07",
"createdAt": "2026-05-22T14:05:00Z",
"updatedAt": "2026-05-22T14:05: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."
}