Skip to main content
GET
Get a trader's signed track record

Authorizations

Authorization
string
header
required

Authorization: Bearer arena_sk_... (the x-arena-key header is accepted too). Keys are made in Settings (https://arena-predictions.com/settings#api-keys) or with arena keys create, shown once, stored hashed.

Path Parameters

traderId
string
required

A trader's user id (uuid) or display name. Names match exactly, ignoring case.

Minimum string length: 2

Response

The signed record, or record null while numbersShown is false.

traderId
string<uuid> | null
required

Null for someone else's private account.

displayName
string | null
required
private
boolean
required

True: the account is private, and record is null.

numbersShown
boolean
required

Others see the account's numbers, as on Trader. False while private, and while public if any earlier trade is still hidden; record is null whenever this is false.

record
object | null
required

The signed envelope exactly as Arena signed it (type arena.track_record, version, issuer, key_id, issued_at, record, signature). Nothing inside it is renamed or reshaped, so a saved copy verifies on its own. record.record carries status (eligible, not_eligible or blocked), window, gates, track_record (scores, P&L in points, which equal paper dollars, and the Kalshi series counted), definitions and a disclosure. Null while numbersShown is false.

keysUrl
string<uri>
required

Arena's published signing keys. Verify against these, never a key a record names.

verify
string
required

How to check the signature, step by step.

mode
string
required
Allowed value: "paper"
note
string

Present while record is null: why there is none.