Skip to main content
GET
Read one trader

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

traderId
string
required

A trader id: tdr_ and 26 characters. GET /v3/traders/lookup finds it by handle.

Pattern: ^tdr_[0-7][0-9a-hjkmnp-tv-z]{25}$

Response

OK

A trader: one person behind accounts on one or more platforms. The envelope carries no wallets; GET /v3/traders/{traderId}/wallets lists them.

kind
string
required

The kind of object, trader here, and the only field to switch on. Skip objects whose kind you do not know.

Allowed value: "trader"
id
string
required

Our id of the object, tdr_ and 26 lowercase base32 characters. Store it: it stays the same across calls and never holds a platform's own id.

canonical
object
required

Fields that mean the same on every platform.

sources
object
required

Capability blocks keyed by platform. A platform key is absent when the object has no side on that platform. A block is absent when the platform cannot provide it (GET /v3/capabilities lists which can) or we hold no reading of it yet. A field is null when the platform left it empty at observedAt or never fills it (unfilled in GET /v3/capabilities). Skip platform keys and blocks you do not know.