Account

List fills

Changed on

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

get/fills

Request

  • Base URL
    https://api.prod.paradex.trade/v1
  • URL
    https://api.prod.paradex.trade/v1/fills
  • Auth
    API key in header Authorization

Query parameters

asset_kind'PERP' | 'PERP_OPTION' | 'OPTION' | 'SPOT'

Asset kind of the fill's market

cursorstring

Returns the ‘next’ paginated page.

end_atinteger

End Time (unix time millisecond)

marketstring

Market symbol

page_sizeinteger

Limit the number of responses in the page

start_atinteger

Start Time (unix time millisecond)

Response

OK

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)

Example response

{
  "next": "eyJmaWx0ZXIiMsIm1hcmtlciI6eyJtYXJrZXIiOiIxNjc1NjUwMDE3NDMxMTAxNjk5N=",
  "prev": "eyJmaWx0ZXIiOnsiTGltaXQiOjkwfSwidGltZSI6MTY4MTY3OTgzNzk3MTMwOTk1MywibWFya2VyIjp7Im1zMjExMD==",
  "results": [
    {
      "account": "0x978532f46745d7fFBa1CDfa1D8C8202D09D89C9E",
      "client_id": "x1234",
      "created_at": 1681375176910,
      "fee": "7.56",
      "fee_currency": "USDC",
      "flags": [
        "[\"interactive\"",
        " \"rpi\"]"
      ],
      "id": "8615262148007718462",
      "leverage": "20",
      "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",
      "size": "0.5",
      "underlying_price": "7.56"
    }
  ]
}

Changes

  • f33feb7333eaRevision changes
    • warning

      added the new ADDRESS_BOOK_NOT_PARADEX_ACCOUNT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_NOT_PARADEX_ACCOUNT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_REPEATED_IN_IMPORT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_REPEATED_IN_IMPORT enum value to the //// response property for the response status

    • warning

      added the new STARKNET_PARENT_ONBOARDING_DISABLED enum value to the //// response property for the response status

    • warning

      added the new STARKNET_PARENT_ONBOARDING_DISABLED enum value to the //// response property for the response status

  • 72c125c93c2bRevision changes
    • warning

      added the new SESSION_EXPIRED enum value to the //// response property for the response status

    • warning

      added the new SESSION_EXPIRED enum value to the //// response property for the response status

    • warning

      added the new SESSION_REVOKED enum value to the //// response property for the response status

    • warning

      added the new SESSION_REVOKED enum value to the //// response property for the response status