API Reference / Transitions
Fetch a single contract transition by ID
Returns one transition between two contract evaluation snapshots, recording how a single item changed (added, updated, or removed) from one snapshot to the next.
/ contracts. v1. Contracts/ GetTransitionRequest body
application/jsonRequired
Request for one transition between two snapshots of a contract.
contractIdstringContract the transition belongs to.
Format"byte" base64
fromSnapshotIdstringEarlier snapshot in the pair the transition diffs.
Format"int64"
toSnapshotIdstringLater snapshot in the pair the transition diffs.
Format"int64"
transitionIdstringTransition identifier.
Format"byte" base64
Response body
application/json
Success
transition?TransitionThe requested transition.
Show attributes
contractId?stringContract this transition belongs to.
Format"byte" base64
createdAt?stringWhen the transition was created.
Format"date-time"
createdBy?stringActor whose contract update triggered the evaluation that produced this transition. Unset for a background evaluation (a periodic re-evaluation sweep, or a SERVICE own-behalf actor).
Format"byte" base64
deletedAt?stringWhen the transition was soft-deleted, if it has been.
Format"date-time"
fromSnapshotId?stringEarlier snapshot in the pair this transition diffs.
Format"int64"
id?stringOpaque 16-byte transition identifier, base64-encoded in JSON.
Format"byte" base64
marketHashName?stringThe item that changed between the two snapshots.
toSnapshotId?stringLater snapshot in the pair this transition diffs.
Format"int64"
type?stringKind of change this transition represents.
Value in"TRANSITION_"TRANSITION_"TRANSITION_
updatedAt?stringWhen the transition was last modified.
Format"date-time"
updatedBy?stringSame actor as created_by. A transition is insert-only, so the two are always stamped identically.
Format"byte" base64
workspaceId?stringWorkspace the transition's contract belongs to.
Format"byte" base64
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/GetTransition" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"fromSnapshotId": "6",
"toSnapshotId": "7",
"transitionId": "dHJhbnNpdGlvbi0wMDAx"
}'const res = await fetch("https://api.goldmine.to/contracts.v1.Contracts/GetTransition", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"fromSnapshotId": "6",
"toSnapshotId": "7",
"transitionId": "dHJhbnNpdGlvbi0wMDAx"
}),
});
const data = await res.json();body := strings.NewReader(`{
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"fromSnapshotId": "6",
"toSnapshotId": "7",
"transitionId": "dHJhbnNpdGlvbi0wMDAx"
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/contracts.v1.Contracts/GetTransition", 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/GetTransition",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"fromSnapshotId": "6",
"toSnapshotId": "7",
"transitionId": "dHJhbnNpdGlvbi0wMDAx"
},
)
data = res.json(){
"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."
}