Goldmine
Intents

List contract intent IDs in a snapshot

POST
/contracts.v1.Contracts/ListIntents

Returns a paged list of intent IDs produced by one contract evaluation snapshot. Use GetIntent or GetIntents to hydrate the full records.

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/ListIntents" \  -H "Content-Type: application/json" \  -d '{    "contractId": "EBESExQVFhcYGRobHB0eHw==",    "snapshotId": "7",    "limit": 100,    "cursor": ""  }'
{
  "intentIds": [
    "aW50ZW50LWl0ZW0tMDAwMQ==",
    "aW50ZW50LWl0ZW0tMDAwMg=="
  ],
  "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."
}

GetIntents

Returns the intents matching the given IDs within a contract snapshot, alongside the IDs that did not resolve.

ListWorkspaceIntentRollup

Returns the workspace's own rolled-up buying or selling intents, one row per item and float window with the workspace's best price and the number of its contracts contributing. Only the caller's own rows are returned.