List fills | Paradex | Documentation

curl -X GET https://api.prod.paradex.trade/v1/fills \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {JWT}'

{
  "next": "eyJmaWx0ZXIiMsIm1hcmtlciI6eyJtYXJrZXIiOiIxNjc1NjUwMDE3NDMxMTAxNjk5N=",
  "prev": "eyJmaWx0ZXIiOnsiTGltaXQiOjkwfSwidGltZSI6MTY4MTY3OTgzNzk3MTMwOTk1MywibWFya2VyIjp7Im1zMjExMD==",
  "results": [
    {
      "account": "0x978532f46745d7fFBa1CDfa1D8C8202D09D89C9E",
      "client_id": "x1234",
      "created_at": 1681375176910,
      "fee": "7.56",
      "fee_currency": "USDC",
      "fill_type": "FILL",
      "flags": [
        "interactive",
        "interactive"
      ],
      "id": "8615262148007718462",
      "liquidity": "TAKER",
      "market": "BTC-USD-PERP",
      "order_id": "1681462103821101699438490000",
      "orderbook_seq_no": 12345,
      "price": "30000.12",
      "realized_funding": "7.56",
      "realized_pnl": "7.56",
      "remaining_size": "0.5",
      "side": "BUY",
      "size": "0.5",
      "underlying_price": "7.56"
    }
  ]
}

This API returns a list of matched orders (i.e. fills) that have been sent to chain for settlement.

Authentication

Authorizationstring

API Key authentication via header

Query parameters

cursorstringOptional

Returns the ‘next’ paginated page.

end_atintegerOptional

End Time (unix time millisecond)

marketstringOptional

Market symbol

page_sizeintegerOptional1-5000Defaults to 100

Limit the number of responses in the page

start_atintegerOptional

Start Time (unix time millisecond)

Response

nextstring

The pointer to fetch next set of records (null if there are no records left)

prevstring

The pointer to fetch previous set of records (null if there are no records left)

resultslist of objects

Array of paginated results

Errors

400

Bad Request Error

401

Unauthorized Error

$	curl -X GET https://api.prod.paradex.trade/v1/fills \
>	-H 'Accept: application/json' \
>	-H 'Authorization: Bearer {JWT}'

1	{
2	"next": "eyJmaWx0ZXIiMsIm1hcmtlciI6eyJtYXJrZXIiOiIxNjc1NjUwMDE3NDMxMTAxNjk5N=",
3	"prev": "eyJmaWx0ZXIiOnsiTGltaXQiOjkwfSwidGltZSI6MTY4MTY3OTgzNzk3MTMwOTk1MywibWFya2VyIjp7Im1zMjExMD==",
4	"results": [
5	{
6	"account": "0x978532f46745d7fFBa1CDfa1D8C8202D09D89C9E",
7	"client_id": "x1234",
8	"created_at": 1681375176910,
9	"fee": "7.56",
10	"fee_currency": "USDC",
11	"fill_type": "FILL",
12	"flags": [
13	"interactive",
14	"interactive"
15	],
16	"id": "8615262148007718462",
17	"liquidity": "TAKER",
18	"market": "BTC-USD-PERP",
19	"order_id": "1681462103821101699438490000",
20	"orderbook_seq_no": 12345,
21	"price": "30000.12",
22	"realized_funding": "7.56",
23	"realized_pnl": "7.56",
24	"remaining_size": "0.5",
25	"side": "BUY",
26	"size": "0.5",
27	"underlying_price": "7.56"
28	}
29	]
30	}