> For the complete documentation index, see [llms.txt](https://docs.pangolin.exchange/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pangolin.exchange/pangoperps/trading-api/assets-withdraw-settle-pnl/get-asset-history.md).

# Get Asset History

### Endpoint

`GET /v1/asset/history`

Mainnet: `https://api.orderly.org/v1/asset/history`

Testnet: `https://testnet-api.orderly.org/v1/asset/history`

Rate limit: 10 requests per 60 seconds.

Returns deposit and withdrawal activity for the authenticated account.

### Authentication

Send the signed-request headers.

* `orderly-timestamp` — required; signed-request timestamp in milliseconds.
* `orderly-account-id` — required; authenticated account ID.
* `orderly-key` — required; public API key.
* `orderly-signature` — required; signature generated for the request.

### Query parameters

* `token` (string, optional) — filter by token symbol.
* `side` (string, optional) — `DEPOSIT` or `WITHDRAW`.
* `status` (string, optional) — `NEW`, `CONFIRM`, `PROCESSING`, `COMPLETED`, `FAILED`, or `PENDING_REBALANCE`.
* `start_t` (number, optional) — include records created at or after this millisecond timestamp.
* `end_t` (number, optional) — include records created at or before this millisecond timestamp.
* `page` (number, optional) — page number starting at 1.
* `size` (number, optional) — number of records per page.

### Response

HTTP 200 — application/json. `success` (boolean) and `data` (object) are required. `data.meta` contains required integer fields `total`, `records_per_page`, and `current_page`. `data.rows` is a required array with required fields: `id` (string), `tx_id` (string transaction hash), `side`, `token`, `amount`, `fee`, `trans_status`, `created_time`, `updated_time`, and `chain_id`. Times are milliseconds. `trans_status` can be `PENDING`, `PENDING_REBALANCE`, `PROCESSING`, `COMPLETED`, or `FAILED`. The root `timestamp` is server time in milliseconds.

```
{
  "success": true,
  "data": {
    "meta": { "total": 9, "records_per_page": 25, "current_page": 1 },
    "rows": [{
      "id": "230707030600002",
      "tx_id": "0x4b0714c63cc7abae72bf68e84e25860b88ca651b7d27dad1e32bf4c027fa5326",
      "side": "WITHDRAW",
      "token": "USDC",
      "amount": 555,
      "fee": 0,
      "trans_status": "FAILED",
      "created_time": 1688699193034,
      "updated_time": 1688699193096,
      "chain_id": "986532"
    }]
  },
  "timestamp": 1702989203989
}
```
