Search
K

Fills

Get fills

Get account fills. Filter by market or start_time, end_time.
GET /fills
Parameters
{
market_id: 'BTC-USD' // (optional)
start_time: 1669629461258298 // (optional)
end_time: 1669629461258298 // (optional)
p_limit: 100, // max rows returned, max 1000
p_page: 0, // pagination page, index begins at 0
p_order: "DESC" // default "DESC" for descending and "ASC" for ascending
}
Example response:
{
"success": true,
"error": "",
"result": [
{'fee': '-0.0178801',
'id': 'BTC-USD-62581592',
'is_maker': False,
'liquidation': False,
'market_id': 'BTC-USD',
'order_id': 'BTC-USD@6509736',
'price': '25543',
'profile_id': 7615,
'side': 'short',
'size': '0.001',
'timestamp': 1676648452088704,
'trade_id': 'BTC-USD-62581590'},
{'fee': '-0.0178801',
'id': 'BTC-USD-62581571',
'is_maker': False,
'liquidation': False,
'market_id': 'BTC-USD',
'order_id': 'BTC-USD@6509702',
'price': '25543',
'profile_id': 7615,
'side': 'short',
'size': '0.001',
'timestamp': 1676648322405711,
'trade_id': 'BTC-USD-62581569'}
]
}
tip: fills are indexed by timestamp, if start_time is not specified, the response will take longer as it will parse through your full order history. Queries with start_time parameter could be up to 10x faster than queries without start_time.

Get fills by order id

Get all account fills for a single order id.
GET /fills/order
Parameters
{
order_id: 'BTC-USD@445126' // (required)
}
Example response:
{
"success": true,
"error": "",
"result": [
{'fee': '-0.0178801',
'id': 'BTC-USD-62581592',
'is_maker': False,
'liquidation': False,
'market_id': 'BTC-USD',
'order_id': 'BTC-USD@6509736',
'price': '25543',
'profile_id': 7615,
'side': 'short',
'size': '0.001',
'timestamp': 1676648452088704,
'trade_id': 'BTC-USD-62581590'},
{'fee': '-0.0178801',
'id': 'BTC-USD-62581571',
'is_maker': False,
'liquidation': False,
'market_id': 'BTC-USD',
'order_id': 'BTC-USD@6509702',
'price': '25543',
'profile_id': 7615,
'side': 'short',
'size': '0.001',
'timestamp': 1676648322405711,
'trade_id': 'BTC-USD-62581569'}
]
}j
Last modified 7mo ago