Fills
Poloniex futures v1/v2 API will be officially offline on November 30, 2024. You can access the V3 API to provide you with a better trading experience.
Get Fills(Deprecated)
Get a list of recent fills.
HTTP Request
GET https://futures-api.poloniex.com/api/v1/fills
Example
GET https://futures-api.poloniex.com/api/v1/fills
API Permission
This endpoint requires the General permission.
REQUEST RATE LIMIT
This API is restricted for each account, the request rate limit is 9 times/3s.
PARAMETERS
You can request fills for specific orders using query parameters. If you need to get your recent trade history with low latency, please query endpoint Get List of Orders Completed in 24H. The requested data is not real-time.
| Param | Type | Description |
|---|---|---|
| orderId | String | [optional] List fills for a specific order only (If you specify orderId, other parameters can be ignored) |
| symbol | String | [optional] Symbol of the contract |
| side | String | [optional] buy or sell |
| type | String | [optional] limit, market, limit_stop or market_stop |
| startAt | long | [optional] Start time (millisecond) |
| endAt | long | [optional] End time (millisecond) |
This request uses pagination.
Data Time Range The system allows you to retrieve data for up to one week (starting from the last day by default). If the time period of the queried data exceeds one week (time range from the start time to end time exceeds 24*7 hours), the system will send a prompt to remind you that you have exceeded the time limit. If you only specified the start time, the system will automatically calculate the end time (end time = start time + 24 hours). On the contrary, if you only specified the end time, the system will calculate the start time (start time= end time - 24 hours) the same way.
Fee
Orders on Poloniex Futures platform are classified into two types, taker and maker. A taker order matches other resting orders on the exchange order book, and gets executed immediately after order entry. A maker order, on the contrary, stays on the exchange order book and awaits to be matched. Taker orders will be charged taker fees, while maker orders will receive maker rebates. Please note that market orders, iceberg orders and hidden orders are always charged taker fees.
The system will pre-freeze a predicted taker fee when you place an order. The liquidity field indicates if the fill was charged taker or maker fees.
The system will pre-freeze the predicted fees (including the maintenance margin needed for the position, entry fees and fees to close positions) if you added the position, and will not pre-freeze fees if you reduced the position. After the order is executed, if you added positions, the system will deduct entry fees from your balance, if you closed positions, the system will deduct the close fees.
PAGINATION
Fills are returned sorted by descending fill time.
This request is paginated.
Example:
{
"code": "200000",
"data": {
"currentPage":1,
"pageSize":1,
"totalNum":251915,
"totalPage":251915,
"items":[
{
"symbol": "BTCUSDTPERP", //Ticker symbol of the contract
"tradeId": "5ce24c1f0c19fc3c58edc47c", //Trade ID
"orderId": "5ce24c16b210233c36ee321d", // Order ID
"side": "sell", //Transaction side
"liquidity": "taker", //Liquidity- taker or maker
"price": "8302", //Filled price
"size": 10, //Filled amount
"value": "0.001204529", //Order value
"feeRate": "0.0005", //Floating fees
"fixFee": "0.00000006", //Fixed fees
"feeCurrency": "XBT", //Charging currency
"stop": "", //A mark to the stop order type
"fee": "0.0000012022", //Transaction fee
"orderType": "limit", //Order type
"tradeType": "trade", //Trade type (trade, liquidation, ADL or settlement)
"createdAt": 1558334496000, //Time the order created
"settleCurrency": "XBT", //settlement currency
"tradeTime": 1558334496000000000 //trade time in nanosecond
}
]
}
}
Active Order Value Calculation
You can query this endpoint to get the the total number and value of the all your active orders.
HTTP Request
GET https://futures-api.poloniex.com/api/v1/openOrderStatistics
Example
GET https://futures-api.poloniex.com/api/v1/openOrderStatistics?symbol=BTCUSDTPERP
API Permission
This endpoint requires the General permission.
REQUEST RATE LIMIT
This API is restricted for each account, the request rate limit is 9 times/3s.
PARAMETERS
| Param | Type | Description |
|---|---|---|
| symbol | String | Symbol of the contract |
Example:
{
"code": "200000",
"data": {
"openOrderBuySize": 20, //Total number of the unexecuted buy orders
"openOrderSellSize": 0, //Total number of the unexecuted sell orders
"openOrderBuyCost": "0.0025252525", //Value of all the unexecuted buy orders
"openOrderSellCost": "0", //Value of all the unexecuted sell orders
"settleCurrency": "XBT" //settlement currency
}
}
Get Fills V2
Get a list of recent fills,Better query performance than v1
HTTP Request
GET https://futures-api.poloniex.com/api/v2/fills
Example
GET https://futures-api.poloniex.com/api/v2/fills
API Permission
This endpoint requires the General permission.
REQUEST RATE LIMIT
This API is restricted for each account, the request rate limit is 9 times/3s.
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| status | NO | String | active or done, done as default. Only list orders for a specific status |
| symbol | NO | String | Symbol of the contract |
| side | NO | String | buy or sell |
| type | NO | String | limit, market, limit_stop or market_stop |
| startAt | NO | long | Start time (millisecond) |
| endAt | NO | long | End time (millisecond) |
| marginType | NO | Number | 0 (Isolated) or 1 (Cross) |
| from | NO | String | The starting id of the query, use the nextId in the response result, and pass 0 for the first time |
| direct | NO | String | PREV - page forward; means starting from the starting id, querying in ascending orderNEXT - page forward; means starting from the starting id, querying in descending order |
| limit | NO | int | Limit of items per page |
Example:
{
"code": "200000",
"data": {
"beforeId": "285013592909307905",
"hasMore": false,
"items":[
{
"symbol": "BTCUSDTPERP", //Ticker symbol of the contract
"tradeId": "5ce24c1f0c19fc3c58edc47c", //Trade ID
"orderId": "5ce24c16b210233c36ee321d", // Order ID
"side": "sell", //Transaction side
"liquidity": "taker", //Liquidity- taker or maker
"price": "8302", //Filled price
"size": 10, //Filled amount
"value": "0.001204529", //Order value
"feeRate": "0.0005", //Floating fees
"fixFee": "0.00000006", //Fixed fees
"feeCurrency": "XBT", //Charging currency
"stop": "", //A mark to the stop order type
"fee": "0.0000012022", //Transaction fee
"orderType": "limit", //Order type
"tradeType": "trade", //Trade type (trade, liquidation, ADL or settlement)
"createdAt": 1558334496000, //Time the order created
"settleCurrency": "XBT", //settlement currency
"tradeTime": 1558334496000000000 //trade time in nanosecond
}
],
"nextId": "285013109771624448"
}
}