Goldmine
Transitions

Fetch a single contract transition by ID

POST
/contracts.v1.Contracts/GetTransition

Returns one transition between two contract evaluation snapshots, recording how a single item changed (added, updated, or removed) from one snapshot to the next.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/contracts.v1.Contracts/GetTransition" \  -H "Content-Type: application/json" \  -d '{    "contractId": "EBESExQVFhcYGRobHB0eHw==",    "fromSnapshotId": "6",    "toSnapshotId": "7",    "transitionId": "dHJhbnNpdGlvbi0wMDAx"  }'
{
  "transition": {
    "contractId": "EBESExQVFhcYGRobHB0eHw==",
    "fromSnapshotId": "6",
    "toSnapshotId": "7",
    "id": "dHJhbnNpdGlvbi0wMDAx",
    "type": "added",
    "marketHashName": "AK-47 | Redline (Field-Tested)",
    "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."
}

GetPnLSummary

Returns the workspace's aggregate profit and loss, including total buy cost, sell revenue, realized and unrealized figures, and item counts. Optionally scoped to one contract and a time range.

GetTransitions

Returns the transitions matching the given IDs between two contract snapshots, alongside the IDs that did not resolve.