Skip to main content
GET
Get Tradeprints

Authorizations

X-River-Key-Id
string
header
required

UUID of your API key (from Settings → API Keys).

X-River-Timestamp
string
header
required

Current unix seconds. Must be within 30s of server time.

X-River-Signature
string
header
required

Base64 Ed25519 signature over the canonical request: METHOD\nPATH\nSORTED_QUERY\nTIMESTAMP\nSHA256(body) hex. See /api-reference/authentication for the full recipe.

Query Parameters

river_ids
integer[]
required

River market IDs (repeat the param for each)

limit
integer
default:50

Max trades returned per market

Required range: 1 <= x <= 200

Response

Successful Response

Response for GET /v1/tradeprints?river_ids=....

results preserves the order of the requested river_ids. Partial failures are surfaced per-row (status not_found) with a message — a bad river_id or upstream error never aborts the whole call.

results
TradeprintsResponse · object[]