Skip to main content
GET
List prediction market fills

Authorizations

X-API-Key
string
header
required

Include in every request header as X-API-Key: <your_key>.

Query Parameters

user
string

Filter by user wallet address (0x...)

coin
string

Filter by coin (e.g. #24371 or @10). Encode # as %23.

outcome_id
integer

Filter by outcome ID

start
integer<int64>

Start time (epoch milliseconds)

end
integer<int64>

End time (epoch milliseconds)

limit
integer
default:100
Required range: x <= 10000
offset
integer
default:0

Response

200 - application/json

OK

user
string

Wallet address

coin
string

Coin (#ID for prediction, @ID for spot outcome token)

outcome_id
integer

Outcome ID extracted from coin

px
number

Execution price

sz
number

Size (number of contracts/tokens)

side
enum<string>

Side: B=Buy, A=Sell

Available options:
B,
A
time_ms
integer<int64>

Execution time (epoch ms)

dir
string

Direction (Buy, Sell, Settlement)

closedPnl
number

Realized PnL

hash
string

Transaction hash

oid
integer<int64>

Order ID

tid
integer<int64>

Trade ID (unique)

fee
number

Fee amount in feeToken denomination

feeToken
string

Fee token (e.g. USDC, USDH, +24371, CHUTORO)

fee_usdc
number

Fee normalized to USD equivalent

typeTrade
string

Trade type

trade_id
string

Trade group ID

market_name
string

Outcome name (from JOIN)

market_description
string

Outcome description (from JOIN)