Goldmine
Snapshots

List contract snapshots

POST
/contracts.v1.Contracts/ListSnapshots

Returns a paged list of evaluation snapshots for a contract, most recent first. Each page carries hydrated entities, so no follow-up GetSnapshots 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/ListSnapshots" \  -H "Content-Type: application/json" \  -d '{    "contractId": "EBESExQVFhcYGRobHB0eHw==",    "limit": 50,    "cursor": ""  }'
{
  "snapshots": [
    {
      "contractId": "EBESExQVFhcYGRobHB0eHw==",
      "id": "7",
      "workspaceId": "AAECAwQFBgcICQoLDA0ODw==",
      "added": "42",
      "updated": "5",
      "deleted": "3",
      "total": "118",
      "createdAt": "2026-04-01T12:15:00Z",
      "updatedAt": "2026-04-01T12:15:00Z"
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjN9"
}
{
  "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."
}

GetSnapshots

Returns the snapshots matching the given sequence numbers for a contract, alongside the IDs that did not resolve.

GetIntent

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.