Skip to main content
GET

Query Parameters

currency
enum<string>

Currency of the fill

Available options:
CASH,
COIN
limit
integer
default:100

Number of fills to return (max 256, default 100)

Required range: x <= 256
offset
integer

Offset of the fills to return

beg
string<date-time>

Beginning timestamp for filtering fills (UTC)

end
string<date-time>

End timestamp for filtering fills (UTC)

marketStatus
enum<string>

Market status of the fill

Available options:
OPEN,
CLOSED,
SETTLED
outcomeStatus
enum<string>

Outcome status of the fill. FMV matches every FMV-settled outcome, whatever its price.

Available options:
TBD,
WIN,
LOSS,
PUSH,
FMV

Response

Successfully retrieved all fills for the user

id
string
required

The ID of the fill

Example:

"123e4567-e89b-12d3-a456-426614174000"

orderId
string
required

The ID of the order that was filled

Example:

"123e4567-e89b-12d3-a456-426614174001"

price
number
required

Price at which the fill executed, as a decimal probability

Example:

0.225

qty
number
required

Quantity filled, in minimum currency units (100 qty = 1.00 CASH)

Example:

75

createdAt
string<date-time>
required

The timestamp when the fill occurred

Example:

"2023-10-05T12:00:00Z"

isWash
boolean
required

Whether the fill is a wash trade

Example:

false

isTaker
boolean
required

Whether your filled order was the taker (true) or the maker (false)

Example:

true

marketId
string
required

The ID of the related market

Example:

"123e4567-e89b-12d3-a456-426614174002"

outcomeId
string
required

The ID of the related outcome

Example:

"123e4567-e89b-12d3-a456-426614174003"

outcomeStatus
string

Grading status of the outcome the fill occurred on: TBD, WIN, LOSS, PUSH, or a decimal string like 0.731 for an outcome settled at fair market value (FMV). Reports the status at the time you read it, not at the time of the fill. Omitted on real-time fill events over the WebSocket private channel.

Example:

"0.731"

fee
string

Total fee charged to you on this fill, as a decimal string in minimum currency units. Omitted when no fee was charged (maker fills, and fills matched while the event was not live), and on real-time fill events.

Example:

"1.4274"

transactions
object[]

Ledger transactions between your wallet and this fill: the FILL_* collateral charge, the FEE_* fee when one was charged, and the MAKER_CREDIT_STRAIGHT maker credit when the fill earned one. Only your own wallet's transactions are listed — a maker never sees the taker's fee here. Omitted on real-time fill events; fetch the fill history to see them.