Skip to main content
GET
List your trades

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.

Headers

X-Arena-Org
string

Organization id. When present, this call uses that organization's paper sandbox. When absent, the key owner's personal paper account. A value that is not an organization id is 400 invalid_request. An unknown organization is 404 organization_not_found and one this key cannot use is 403 organization_forbidden. The personal account is never the fallback. Paper only. This header does not select a Combine evaluation account.

Maximum string length: 63

Query Parameters

status
enum<string>
default:all

settled: won or lost. void: a push or a cancelled market.

Available options:
open,
settled,
sold,
void,
all
since
string<date-time>

Opened at or after.

until
string<date-time>

Opened before.

limit
integer
default:50
Required range: 1 <= x <= 200
cursor
string

The nextCursor of the previous page. Opaque.

Response

A page of trades.

trades
object[]
required
count
integer
required
nextCursor
string | null
required
venueData
boolean
required
mode
string
required
Allowed value: "paper"
organization
object

Present when X-Arena-Org selected an organization sandbox. Absent on the personal account.