Skip to content

API Reference / Intents

List contracts contributing to one workspace target

Returns a bounded page of the caller workspace's current active-intent contributors for an exact item, either for one side and float window or, with side unspecified, for every side and 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.

POST/contracts.v1.Contracts/ListWorkspaceIntentContributors

Request body

application/jsonRequired

Request for one page of the caller's contracts currently wanting an exact item, either for one side and float window or for every side and window at once.

cursor?string

Opaque cursor from this exact target tuple. Empty starts the first page. Changing the tuple requires a new cursor.

limit?integer

Maximum contributors on this page, default 50 and maximum 100.

Format"int32"

marketHashName?string

Exact target market_hash_name, not a substring search.

maxFloat?number

Exact target upper bound. Omitted means 1.0, matching an unbounded upper window. Explicit zero is preserved. Bounds must be finite and ordered within [0,1].

Format"double"

minFloat?number

Exact target lower bound. Omitted means 0.0, matching an unbounded lower window. Explicit zero is preserved.

Format"double"

side?string

Exact target direction: BUYING or SELLING. Unset reads every contributor to the item on both sides and in every float window, ordered by side, float window and contract, so one read answers an item page. Min_float and max_float must then be absent.

Value in"CONTRACT_TYPE_BUYING""CONTRACT_TYPE_SELLING"

Response body

application/json

Success

contributors?array<WorkspaceIntentContributor>

Current same-workspace contributors with their actual snapshot and source-price breakdown, ordered by contract identity for one exact tuple, or by side (buying first), min_float, max_float and contract identity when every side was requested. This is provenance, not global winner selection or execution eligibility.

Show attributes
contractId?string

This workspace's contributing contract identity.

Format"byte" base64

contractName?string

Current name of the nondeleted contributing contract.

contractStatus?string

Current contract lifecycle status. Contribution alone does not establish execution eligibility.

Value in"CONTRACT_STATUS_DRAFT""CONTRACT_STATUS_BUILDING""CONTRACT_STATUS_ACTIVE"

maxFloat?number

Upper bound of this contributor's float window. 1.0 means no upper bound.

Format"double"

minFloat?number

Lower bound of this contributor's float window. 0.0 means no lower bound.

Format"double"

priceCents?string

This contributor's computed max price or sell price in cents. Not the workspace rollup maximum or a guaranteed execution price.

Format"int64"

referencePrices?array<ReferencePrice>

Actual resolved source prices and adjustments stored on this contributing intent.

Show attributes
lastObservedAt?string

For a stale reference, when last_value_cents was observed. Set only when outcome is stale.

Format"date-time"

lastValueCents?string

For a stale reference, the last value the source reported before the reference's adjustment, in US cents. Set only when outcome is stale.

Format"int64"

metric?string

The metric read for a market data lookup. Absent for a sale computation.

observedAt?string

When the figure behind value_cents was observed: the market observation's own time for a market data lookup, or the newest sale in the window for a sale computation. Absent when value_cents is absent.

Format"date-time"

outcome?string

Whether the reference resolved a price, found only an observation older than its freshness window, or found no data at all.

Value in"REFERENCE_PRICE_OUTCOME_RESOLVED""REFERENCE_PRICE_OUTCOME_STALE""REFERENCE_PRICE_OUTCOME_MISSING"

priceCents?string

The price after the reference's adjustment, in US cents, which the valuation strategy combines. Absent when the source had no usable data.

Format"int64"

referenceIndex?integer

Zero-based position of the reference in the valuation's references.

Format"int32"

source?string

The reference's market source, such as "market-csgo".

valueCents?string

The price the source gave before the reference's adjustment, in US cents. Absent when the source had no usable data.

Format"int64"

side?string

The direction of this contributor's intent, its contract's type: BUYING or SELLING.

Value in"CONTRACT_TYPE_BUYING""CONTRACT_TYPE_SELLING"

snapshotId?string

Evaluation snapshot that introduced this active intent's current version (the latest snapshot that added it or changed its price or float window), preserved as an exact integer. It can be older than the contract's current snapshot, and history retention can remove it.

Format"int64"

nextCursor?string

Cursor for the next bounded page of this exact tuple. Empty when complete.

ownershipCoverage?OwnershipCoverage

Optional aggregate workspace ownership proof assessment. Matching contributors remain visible when ownership is unknown. This does not assert global winner or execution eligibility.

Show attributes
complete?boolean

True only when every authoritative workspace account has a matching current-lifecycle, complete and fresh context-2 ownership proof.

freshCompleteAccounts?integer

Recorded accounts with complete, fresh proofs. This count alone does not certify membership or zero ownership.

Format"int32"

reason?string

Overall proof assessment. Membership mismatch includes unobserved or changed account identities. Pending, failed and stale observations remain distinguishable in recorded_reasons.

Value in"OWNERSHIP_COVERAGE_REASON_COMPLETE""OWNERSHIP_COVERAGE_REASON_PENDING""OWNERSHIP_COVERAGE_REASON_UNKNOWN_BODY""OWNERSHIP_COVERAGE_REASON_PRIVATE""OWNERSHIP_COVERAGE_REASON_AUTHENTICATION""OWNERSHIP_COVERAGE_REASON_RATE_LIMITED""OWNERSHIP_COVERAGE_REASON_UNAVAILABLE""OWNERSHIP_COVERAGE_REASON_UNPROVEN_READ""OWNERSHIP_COVERAGE_REASON_STALE""OWNERSHIP_COVERAGE_REASON_MEMBERSHIP_MISMATCH"

recordedAccounts?integer

Nondeleted locally recorded accounts in the workspace. May differ from authoritative membership during bootstrap or lifecycle changes.

Format"int32"

recordedReasons?array<OwnershipCoverageReasonCount>

Bounded aggregate counts by recorded proof reason. No account names, Steam IDs, timestamps or membership fingerprint are returned.

Show attributes
accountCount?integer

Number of recorded observations with this reason. These are not certified current-member counts when membership does not match.

Format"int32"

reason?string

Bounded reason for these locally recorded account observations.

Value in"OWNERSHIP_COVERAGE_REASON_COMPLETE""OWNERSHIP_COVERAGE_REASON_PENDING""OWNERSHIP_COVERAGE_REASON_UNKNOWN_BODY""OWNERSHIP_COVERAGE_REASON_PRIVATE""OWNERSHIP_COVERAGE_REASON_AUTHENTICATION""OWNERSHIP_COVERAGE_REASON_RATE_LIMITED""OWNERSHIP_COVERAGE_REASON_UNAVAILABLE""OWNERSHIP_COVERAGE_REASON_UNPROVEN_READ""OWNERSHIP_COVERAGE_REASON_STALE""OWNERSHIP_COVERAGE_REASON_MEMBERSHIP_MISMATCH"

totalAccounts?integer

Authoritative workspace account total. Absent when the native membership read failed. Explicit zero means a verified empty membership, not unknown coverage.

Format"int32"

curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/ListWorkspaceIntentContributors" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "",
    "limit": 50,
    "marketHashName": "AK-47 | Redline (Field-Tested)",
    "maxFloat": 3,
    "minFloat": 3,
    "side": "CONTRACT_TYPE_BUYING"
  }'
{
  "contributors": [
    {
      "contractId": "AY86PB0ufwCKGyw9Tl9gcQ==",
      "contractName": "Rifle accounts",
      "contractStatus": "CONTRACT_STATUS_DRAFT",
      "maxFloat": 3,
      "minFloat": 3,
      "priceCents": "2360",
      "referencePrices": [
        {}
      ],
      "side": "CONTRACT_TYPE_BUYING",
      "snapshotId": "3"
    }
  ],
  "nextCursor": "",
  "ownershipCoverage": {
    "complete": false,
    "freshCompleteAccounts": 3,
    "reason": "OWNERSHIP_COVERAGE_REASON_COMPLETE",
    "recordedAccounts": 3,
    "recordedReasons": [
      {
        "accountCount": 3,
        "reason": "OWNERSHIP_COVERAGE_REASON_COMPLETE"
      }
    ],
    "totalAccounts": 3
  }
}