Goldmine
Transitions

List contract transitions

POST
/contracts.v1.Contracts/ListTransitions

Returns a paged list of transitions for a contract, optionally scoped to the changes between two specific snapshots. Each page carries hydrated entities, so no follow-up GetTransitions is needed.

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

curl -X POST "https://loading/contracts.v1.Contracts/ListTransitions" \  -H "Content-Type: application/json" \  -d '{    "contractId": "EBESExQVFhcYGRobHB0eHw==",    "fromSnapshotId": "6",    "toSnapshotId": "7",    "limit": 100,    "cursor": ""  }'
{
  "transitions": [
    {
      "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"
    }
  ],
  "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."
}

GetTransitions

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

AddProxyToPool

Adds an existing proxy to a legacy proxy pool's membership. Both the pool and the proxy must already belong to your workspace; a proxy already a member of the pool reports ALREADY_EXISTS.