Goldmine
Intents

List contracts contributing to one workspace target

POST
/contracts.v1.Contracts/ListWorkspaceIntentContributors

Returns a bounded page of the caller workspace's current active-intent contributors for an exact item, side and float window, joined to nondeleted contracts. Includes current contract name/status, the intent's evaluation snapshot and its actual price breakdown. Contribution does not imply execution eligibility or global assignment.

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/ListWorkspaceIntentContributors" \  -H "Content-Type: application/json" \  -d '{}'
{
  "contributors": [
    {
      "contractId": "string",
      "contractName": "string",
      "contractStatus": "CONTRACT_STATUS_UNSPECIFIED",
      "priceCents": "string",
      "referencePrices": [
        {
          "metric": "string",
          "priceCents": "string",
          "referenceIndex": 0,
          "source": "string",
          "valueCents": "string"
        }
      ],
      "snapshotId": "string"
    }
  ],
  "nextCursor": "string"
}
{
  "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."
}

ListIntents

Returns a paged list of intents produced by one contract evaluation snapshot. Each page carries hydrated entities, so no follow-up GetIntents is needed.

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, with server-side price/name/contributor-count ordering before pagination.