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.
/ contracts. v1. Contracts/ ListWorkspaceIntentContributorsRequest 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?stringOpaque cursor from this exact target tuple. Empty starts the first page. Changing the tuple requires a new cursor.
limit?integerMaximum contributors on this page, default 50 and maximum 100.
Format"int32"
marketHashName?stringExact target market_hash_name, not a substring search.
maxFloat?numberExact 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?numberExact target lower bound. Omitted means 0.0, matching an unbounded lower window. Explicit zero is preserved.
Format"double"
side?stringExact 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_"CONTRACT_
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?stringThis workspace's contributing contract identity.
Format"byte" base64
contractName?stringCurrent name of the nondeleted contributing contract.
contractStatus?stringCurrent contract lifecycle status. Contribution alone does not establish execution eligibility.
Value in"CONTRACT_"CONTRACT_"CONTRACT_
maxFloat?numberUpper bound of this contributor's float window. 1.0 means no upper bound.
Format"double"
minFloat?numberLower bound of this contributor's float window. 0.0 means no lower bound.
Format"double"
priceCents?stringThis 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?stringFor a stale reference, when last_value_cents was observed. Set only when outcome is stale.
Format"date-time"
lastValueCents?stringFor 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?stringThe metric read for a market data lookup. Absent for a sale computation.
observedAt?stringWhen 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?stringWhether the reference resolved a price, found only an observation older than its freshness window, or found no data at all.
Value in"REFERENCE_"REFERENCE_"REFERENCE_
priceCents?stringThe 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?integerZero-based position of the reference in the valuation's references.
Format"int32"
source?stringThe reference's market source, such as "market-csgo".
valueCents?stringThe price the source gave before the reference's adjustment, in US cents. Absent when the source had no usable data.
Format"int64"
side?stringThe direction of this contributor's intent, its contract's type: BUYING or SELLING.
Value in"CONTRACT_"CONTRACT_
snapshotId?stringEvaluation 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?stringCursor for the next bounded page of this exact tuple. Empty when complete.
ownershipCoverage?OwnershipCoverageOptional 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?booleanTrue only when every authoritative workspace account has a matching current-lifecycle, complete and fresh context-2 ownership proof.
freshCompleteAccounts?integerRecorded accounts with complete, fresh proofs. This count alone does not certify membership or zero ownership.
Format"int32"
reason?stringOverall proof assessment. Membership mismatch includes unobserved or changed account identities. Pending, failed and stale observations remain distinguishable in recorded_reasons.
Value in"OWNERSHIP_"OWNERSHIP_"OWNERSHIP_"OWNERSHIP_"OWNERSHIP_"OWNERSHIP_"OWNERSHIP_"OWNERSHIP_"OWNERSHIP_"OWNERSHIP_
recordedAccounts?integerNondeleted 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?integerNumber of recorded observations with this reason. These are not certified current-member counts when membership does not match.
Format"int32"
reason?stringBounded reason for these locally recorded account observations.
Value in"OWNERSHIP_"OWNERSHIP_"OWNERSHIP_"OWNERSHIP_"OWNERSHIP_"OWNERSHIP_"OWNERSHIP_"OWNERSHIP_"OWNERSHIP_"OWNERSHIP_
totalAccounts?integerAuthoritative workspace account total. Absent when the native membership read failed. Explicit zero means a verified empty membership, not unknown coverage.
Format"int32"
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 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/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"
}'const res = await fetch("https://api.goldmine.to/contracts.v1.Contracts/ListWorkspaceIntentContributors", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"cursor": "",
"limit": 50,
"marketHashName": "AK-47 | Redline (Field-Tested)",
"maxFloat": 3,
"minFloat": 3,
"side": "CONTRACT_TYPE_BUYING"
}),
});
const data = await res.json();body := strings.NewReader(`{
"cursor": "",
"limit": 50,
"marketHashName": "AK-47 | Redline (Field-Tested)",
"maxFloat": 3,
"minFloat": 3,
"side": "CONTRACT_TYPE_BUYING"
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/contracts.v1.Contracts/ListWorkspaceIntentContributors", 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/ListWorkspaceIntentContributors",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"cursor": "",
"limit": 50,
"marketHashName": "AK-47 | Redline (Field-Tested)",
"maxFloat": 3,
"minFloat": 3,
"side": "CONTRACT_TYPE_BUYING"
},
)
data = res.json(){
"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
}
}{
"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."
}