Sign in
Trades

List Trades

Lists trades you can access, newest first. User credentials see their own trades and those of accounts they belong to, including connected accounts; account credentials see their account and its connected accounts. These are submission records, not fill or position history.

get/trades

Query parameters

account_idstring

Only return trades for this account or user, prefixed biz_ or user_.

status'pending' | 'submitted' | 'completed' | 'failed' | 'submission_unknown'

Only return trades with this submission status.

operation_type'create_orders' | 'cancel_orders' | 'update_leverage'

Only return trades of this kind, such as create_orders for order submissions.

order'created_at' | 'updated_at'

Field to sort by.

direction'asc' | 'desc'

Sort direction.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

Response

trades listed

Example response

{
  "data": [
    {
      "account_id": "biz_xxxxxxxxxxxxxx",
      "cancellations": [
        {
          "id": "trdcloid_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
          "status": "canceled"
        }
      ],
      "completed_at": "2026-01-01T12:00:00.000Z",
      "created_at": "2026-01-01T12:00:00.000Z",
      "failure_code": "pre_submission_error",
      "id": "trop_xxxxxxxxxxxxxx",
      "instrument_type": "perpetual",
      "leverage": {
        "leverage": 5,
        "margin_mode": "isolated",
        "market": "ETH"
      },
      "metadata": {},
      "object": "trade",
      "operation_type": "cancel_orders",
      "orders": [
        {
          "average_price": {
            "amount": "-2.50",
            "currency": "usd",
            "decimals": 2,
            "display_decimals": 2
          },
          "hyperliquid": {
            "trigger_price": {
              "amount": "-2.50",
              "currency": "usd",
              "decimals": 2,
              "display_decimals": 2
            }
          },
          "object": "trading_order",
          "order_type": "limit",
          "price": {
            "amount": "-2.50",
            "currency": "usd",
            "decimals": 2,
            "display_decimals": 2
          },
          "side": "buy",
          "status": "open"
        }
      ],
      "provider": "hyperliquid",
      "requested_orders": [
        {
          "client_order_id": "trdcloid_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
          "market": "ETH",
          "order_type": "stop_loss",
          "parent_client_order_id": "trdcloid_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
          "price": {
            "amount": "-2.50",
            "currency": "usd",
            "decimals": 2,
            "display_decimals": 2
          },
          "side": "sell",
          "size": "0.02",
          "trigger_price": {
            "amount": "-2.50",
            "currency": "usd",
            "decimals": 2,
            "display_decimals": 2
          }
        }
      ],
      "status": "completed",
      "trade_id": "trop_xxxxxxxxxxxxxx",
      "updated_at": "2026-01-01T12:00:00.000Z"
    }
  ],
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes

Changed in 3 of the 74 revisions of this API.5

  • 78e1ed7366cd2See the full diff
    • ○

      the security scope crypto_wallet:trade:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope crypto_wallet:manage was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 73dd0533cd812See the full diff
    • ○

      the security scope crypto_wallet:trade:read was added to the endpoint's security scheme bearerAuth

      api-security-scope-added

    • ○

      the security scope crypto_wallet:manage was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 86b97292852d1See the full diff
    • ○

      endpoint added

      endpoint-added

Of the 74 revisions, 1 has no diff computed.