Skip to content

API Reference / Snapshots

Fetch a single contract snapshot by ID

Returns one evaluation snapshot of a contract, summarizing how many intents were added, updated, or removed and the total in effect. Snapshots bind an evaluation run to a fixed contract state.

POST/contracts.v1.Contracts/GetSnapshot

Request body

application/jsonRequired

Request for one snapshot of a contract.

contractIdstring

Contract the snapshot belongs to.

Format"byte" base64

snapshotIdstring

Snapshot identifier.

Format"int64"

Response body

application/json

Success

snapshot?Snapshot

The requested snapshot.

Show attributes
added?string

Number of intents newly added in this snapshot, compared to the previous one.

Format"int64"

contractId?string

Contract this snapshot evaluated.

Format"byte" base64

createdAt?string

When the snapshot was created.

Format"date-time"

createdBy?string

Actor whose contract update triggered the evaluation that produced this snapshot. Unset for a background evaluation (a periodic re-evaluation sweep, or a SERVICE own-behalf actor).

Format"byte" base64

deleted?string

Number of intents removed in this snapshot, compared to the previous one.

Format"int64"

deletedAt?string

When the snapshot was soft-deleted, if it has been.

Format"date-time"

id?string

Snapshot sequence number, monotonic per contract. The first snapshot is 1.

Format"int64"

inputConfigVersion?string

Captured contract configuration version used by the evaluation that created this snapshot. Unset when unknown. An explicit zero is a known version.

Format"int64"

inputGeneration?string

Opaque completed-market-feed fingerprint used by the evaluation that created this immutable snapshot. Unset when provenance is unknown. This does not certify independently mutable catalog, primitive observations, sales, or exchange rates. Reusing a snapshot preserves its original generation.

total?string

Total number of intents in effect after this snapshot.

Format"int64"

updated?string

Number of intents whose price or float window changed in this snapshot, compared to the previous one.

Format"int64"

updatedAt?string

When the snapshot was last modified.

Format"date-time"

updatedBy?string

Same actor as created_by. A snapshot is insert-only, so the two are always stamped identically.

Format"byte" base64

workspaceId?string

Workspace the snapshot's contract belongs to.

Format"byte" base64

curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/GetSnapshot" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contractId": "EBESExQVFhcYGRobHB0eHw==",
    "snapshotId": "7"
  }'
{
  "snapshot": {
    "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"
  }
}