# Get order history for an asset

`GET /api/orders/{trader}/{asset}/history`

## Authorization



## Parameters

- path: trader (string; required). 

Type: string

Example: "0:72c310c83de5060d21674d58379b9a153854338a63d82588f8d912f83a3f8660"

- path: asset (string; required). Position base asset

Type: string

Example: "BTC"

minLength: 1

- query: statuses (string · enum[]; optional). 

Type: string · enum[]

[]Type: string · enum

[]Allowed values: ["seq_pending","seq_executing","active","pending","tx_sent","executed","canceled","canceled_by_sequencer","expired","error"]

- query: direction (string · enum; optional). 

Type: string · enum

Allowed values: ["long","short"]

- query: limit (integer; optional). 

Type: integer

Default: 20

- query: offset (integer; optional). 

Type: integer

Default: 0

- query: walletId (string; optional). 

Type: string

## Example · cURL

```bash
curl --request GET 'https://api.storm.tg/api/orders/{trader}/{asset}/history' \
  --header 'Accept: application/json'
```

## Example · JavaScript

```javascript
const response = await fetch("https://api.storm.tg/api/orders/{trader}/{asset}/history", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  },
});
console.log(response.status, await response.text());
```

## Example · Python

```python
import requests

response = requests.request(
    "GET",
    "https://api.storm.tg/api/orders/{trader}/{asset}/history",
    headers={"Accept":"application/json"},
    timeout=30,
)
print(response.status_code, response.text)
```

## Response 200

**200** application/json — Response

Type: object

Required fields: data, totalCount

Required field types: data (object[]; required), totalCount (integer; required)

- data (object[]; required)

data example: [
  {
    "id": "string",
    "txId": "string",
    "trader": "0:72c310c83de5060d21674d58379b9a153854338a63d82588f8d912f83a3f8660",
    "masterTrader": "0:72c310c83de5060d21674d58379b9a153854338a63d82588f8d912f83a3f8660",
    "market": "0:72c310c83de5060d21674d58379b9a153854338a63d82588f8d912f83a3f8660",
    "status": "seq_pending",
    "type": "market",
    "direction": "long",
    "stopPrice": "0",
    "limitPrice": "0",
    "stopTriggerPrice": "0",
    "takeTriggerPrice": "0",
    "leverage": "0",
    "index": 0,
    "positionId": "string",
    "expiration": "2026-01-01T00:00:00Z",
    "amount": "0",
    "indexPrice": "0",
    "settlementOraclePrice": "0",
    "createdAt": "2026-01-01T00:00:00Z",
    "error": "string"
  }
]

data.Type: object[]

data.[]Schema: Data.OrderResponse

data.[]Type: object

data.[]Required fields: id, txId, trader, masterTrader, market, status, type, direction, stopPrice, limitPrice, stopTriggerPrice, takeTriggerPrice, leverage, index, positionId, expiration, amount, indexPrice, settlementOraclePrice, createdAt, error

data.[]Required field types: id (string; required), txId (string; required), trader (string; required), masterTrader (string; required), market (string; required), status (string · enum; required), type (string · enum; required), direction (string · enum; required), stopPrice (string · int64 · nullable; required), limitPrice (string · int64 · nullable; required), stopTriggerPrice (string · int64 · nullable; required), takeTriggerPrice (string · int64 · nullable; required), leverage (string · int64 · nullable; required), index (number · nullable; required), positionId (string · nullable; required), expiration (string · date-time · nullable; required), amount (string · int64 · nullable; required), indexPrice (string · int64 · nullable; required), settlementOraclePrice (string · int64 · nullable; required), createdAt (string · date-time; required), error (string · nullable; required)

- data.[]id (string; required)

data.[]id example: string

data.[]id.Type: string

- data.[]txId (string; required)

data.[]txId example: string

data.[]txId.Type: string

- data.[]trader (string; required)

data.[]trader example: 0:72c310c83de5060d21674d58379b9a153854338a63d82588f8d912f83a3f8660

data.[]trader.Type: string

- data.[]masterTrader (string; required)

data.[]masterTrader example: 0:72c310c83de5060d21674d58379b9a153854338a63d82588f8d912f83a3f8660

data.[]masterTrader.Type: string

- data.[]market (string; required)

data.[]market example: 0:72c310c83de5060d21674d58379b9a153854338a63d82588f8d912f83a3f8660

data.[]market.Type: string

- data.[]status (string · enum; required)

data.[]status example: seq_pending

data.[]status.Type: string · enum

data.[]status.Allowed values: ["seq_pending","seq_executing","active","pending","tx_sent","executed","canceled","canceled_by_sequencer","expired","error"]

- data.[]type (string · enum; required)

data.[]type example: market

data.[]type.Type: string · enum

data.[]type.Allowed values: ["market","stop","take","limit","liquidation","max_pnl","add_margin","remove_margin"]

- data.[]direction (string · enum; required)

data.[]direction example: long

data.[]direction.Type: string · enum

data.[]direction.Allowed values: ["long","short"]

- data.[]stopPrice (string · int64 · nullable; required)

data.[]stopPrice example: 0

data.[]stopPrice.Type: string · int64 · nullable

data.[]stopPrice.format: int64

data.[]stopPrice.pattern: ^(0|-?[1-9][0-9]*)$

- data.[]limitPrice (string · int64 · nullable; required)

data.[]limitPrice example: 0

data.[]limitPrice.Type: string · int64 · nullable

data.[]limitPrice.format: int64

data.[]limitPrice.pattern: ^(0|-?[1-9][0-9]*)$

- data.[]stopTriggerPrice (string · int64 · nullable; required)

data.[]stopTriggerPrice example: 0

data.[]stopTriggerPrice.Type: string · int64 · nullable

data.[]stopTriggerPrice.format: int64

data.[]stopTriggerPrice.pattern: ^(0|-?[1-9][0-9]*)$

- data.[]takeTriggerPrice (string · int64 · nullable; required)

data.[]takeTriggerPrice example: 0

data.[]takeTriggerPrice.Type: string · int64 · nullable

data.[]takeTriggerPrice.format: int64

data.[]takeTriggerPrice.pattern: ^(0|-?[1-9][0-9]*)$

- data.[]leverage (string · int64 · nullable; required)

data.[]leverage example: 0

data.[]leverage.Type: string · int64 · nullable

data.[]leverage.format: int64

data.[]leverage.pattern: ^(0|-?[1-9][0-9]*)$

- data.[]index (number · nullable; required)

data.[]index example: 0

data.[]index.Type: number · nullable

- data.[]positionId (string · nullable; required)

data.[]positionId example: string

data.[]positionId.Type: string · nullable

- data.[]expiration (string · date-time · nullable; required)

data.[]expiration example: 2026-01-01T00:00:00Z

data.[]expiration.Type: string · date-time · nullable

data.[]expiration.format: date-time

- data.[]amount (string · int64 · nullable; required)

data.[]amount example: 0

data.[]amount.Type: string · int64 · nullable

data.[]amount.format: int64

data.[]amount.pattern: ^(0|-?[1-9][0-9]*)$

- data.[]indexPrice (string · int64 · nullable; required)

data.[]indexPrice example: 0

data.[]indexPrice.Type: string · int64 · nullable

data.[]indexPrice.format: int64

data.[]indexPrice.pattern: ^(0|-?[1-9][0-9]*)$

- data.[]settlementOraclePrice (string · int64 · nullable; required)

data.[]settlementOraclePrice example: 0

data.[]settlementOraclePrice.Type: string · int64 · nullable

data.[]settlementOraclePrice.format: int64

data.[]settlementOraclePrice.pattern: ^(0|-?[1-9][0-9]*)$

- data.[]createdAt (string · date-time; required)

data.[]createdAt example: 2026-01-01T00:00:00Z

data.[]createdAt.Type: string · date-time

data.[]createdAt.format: date-time

- data.[]error (string · nullable; required)

data.[]error example: string

data.[]error.Type: string · nullable

- totalCount (integer; required)

totalCount example: 0

totalCount.Type: integer

totalCount.minimum: 0

Example



```json
{
  "data": [],
  "totalCount": 0
}
```