> For the complete documentation index, see [llms.txt](https://docs.1dex.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.1dex.com/developer/restful-api-reference/account-endpoints.md).

# Account Endpoints

## Get user info

> Get user info

```json
{"openapi":"3.0.1","info":{"title":"1dex api v1","version":"1.0"},"servers":[{"url":"https://api-v1.1dex.com"},{"url":"https://api-test-v1.1dex.com"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"api.Response":{"type":"object","properties":{"code":{"type":"integer","format":"uint32","description":"Response status code"},"message":{"type":"string","description":"Response message"},"data":{"description":"Response data payload (can be any type)"},"meta":{"type":"object","additionalProperties":true,"description":"Additional metadata with dynamic keys"}}},"entity.RespV1UserInfo":{"type":"object","properties":{"eos_account":{"type":"string"},"parent_eos_account":{"type":"string"},"permission":{"type":"string"}}}}},"paths":{"/api/v1/info":{"get":{"tags":["Account Endpoints"],"summary":"Get user info","description":"Get user info","responses":{"200":{"description":"user info","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.Response","properties":{"data":{"$ref":"#/components/schemas/entity.RespV1UserInfo"}}}}}}}}}}}
```

## Get user balances

> Get user balances

```json
{"openapi":"3.0.1","info":{"title":"1dex api v1","version":"1.0"},"servers":[{"url":"https://api-v1.1dex.com"},{"url":"https://api-test-v1.1dex.com"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"api.Response":{"type":"object","properties":{"code":{"type":"integer","format":"uint32","description":"Response status code"},"message":{"type":"string","description":"Response message"},"data":{"description":"Response data payload (can be any type)"},"meta":{"type":"object","additionalProperties":true,"description":"Additional metadata with dynamic keys"}}},"entity.SubAccountBalance":{"type":"object","properties":{"balance":{"type":"string"},"coin":{"type":"string"},"locked":{"type":"string"},"locks":{"type":"array","items":{"$ref":"#/components/schemas/entity.LockBalance"}},"usdt_price":{"type":"string"}}},"entity.LockBalance":{"type":"object","properties":{"balance":{"type":"string"},"pool_id":{"type":"integer"},"pool_symbol":{"type":"string"}}}}},"paths":{"/api/v1/balances":{"get":{"tags":["Account Endpoints"],"summary":"Get user balances","description":"Get user balances","responses":{"200":{"description":"user balances","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.Response","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/entity.SubAccountBalance"}}}}}}}}}}}}
```

## Get history orders

> Get history orders

```json
{"openapi":"3.0.1","info":{"title":"1dex api v1","version":"1.0"},"servers":[{"url":"https://api-v1.1dex.com"},{"url":"https://api-test-v1.1dex.com"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"api.Response":{"type":"object","properties":{"code":{"type":"integer","format":"uint32","description":"Response status code"},"message":{"type":"string","description":"Response message"},"data":{"description":"Response data payload (can be any type)"},"meta":{"type":"object","additionalProperties":true,"description":"Additional metadata with dynamic keys"}}},"entity.Order":{"type":"object","properties":{"avg_price":{"type":"string"},"base_coin_precision":{"type":"integer"},"executed_amount":{"type":"string"},"filled_total":{"type":"string"},"history":{"type":"boolean"},"id":{"type":"string"},"order_amount":{"type":"string"},"order_cid":{"type":"string"},"order_id":{"type":"integer"},"order_price":{"type":"string"},"order_time":{"type":"string"},"order_total":{"type":"string"},"permission":{"type":"string"},"pool_base_coin":{"type":"string"},"pool_id":{"type":"integer"},"pool_quote_coin":{"type":"string"},"pool_symbol":{"type":"string"},"quote_coin_precision":{"type":"integer"},"side":{"type":"integer","description":"0 buy 1 sell"},"status":{"type":"integer","description":"0 open 1partially_filled 2full_filled 3.canceled"},"trader":{"type":"string"},"type":{"type":"integer","description":"0 market 1 limit"},"unread":{"type":"boolean"}}}}},"paths":{"/api/v1/history-orders":{"get":{"tags":["Account Endpoints"],"summary":"Get history orders","description":"Get history orders","parameters":[{"name":"pool_id","in":"query","description":"pool_id","schema":{"type":"string"}},{"name":"side","in":"query","description":"0 buy 1 sell","schema":{"type":"string"}},{"name":"type","in":"query","description":"0 market 1limit","schema":{"type":"string"}},{"name":"status","in":"query","description":"status","schema":{"type":"string"}}],"responses":{"200":{"description":"history orders","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.Response","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/entity.Order"}}}}}}}}}}}}
```

## Get open orders

> Get open orders

```json
{"openapi":"3.0.1","info":{"title":"1dex api v1","version":"1.0"},"servers":[{"url":"https://api-v1.1dex.com"},{"url":"https://api-test-v1.1dex.com"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"api.Response":{"type":"object","properties":{"code":{"type":"integer","format":"uint32","description":"Response status code"},"message":{"type":"string","description":"Response message"},"data":{"description":"Response data payload (can be any type)"},"meta":{"type":"object","additionalProperties":true,"description":"Additional metadata with dynamic keys"}}},"entity.OpenOrder":{"type":"object","properties":{"avg_price":{"type":"string"},"base_coin_precision":{"type":"integer"},"executed_amount":{"type":"string"},"id":{"type":"string"},"order_amount":{"type":"string"},"order_cid":{"type":"string"},"order_id":{"type":"integer"},"order_price":{"type":"string"},"order_time":{"type":"string"},"order_total":{"type":"string"},"pool_base_coin":{"type":"string"},"pool_id":{"type":"integer"},"pool_quote_coin":{"type":"string"},"pool_symbol":{"type":"string"},"quote_coin_precision":{"type":"integer"},"side":{"type":"integer","description":"0 buy 1 sell"},"trader":{"type":"string"},"type":{"type":"integer","description":"0 market 1 limit"}}}}},"paths":{"/api/v1/open-orders":{"get":{"tags":["Account Endpoints"],"summary":"Get open orders","description":"Get open orders","parameters":[{"name":"pool_id","in":"query","description":"pool_id","schema":{"type":"string"}},{"name":"side","in":"query","description":"0 buy 1 sell","schema":{"type":"string"}}],"responses":{"200":{"description":"open order list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.Response","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/entity.OpenOrder"}}}}}}}}}}}}
```

## Get history order detail

> Get history order detail

```json
{"openapi":"3.0.1","info":{"title":"1dex api v1","version":"1.0"},"servers":[{"url":"https://api-v1.1dex.com"},{"url":"https://api-test-v1.1dex.com"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"api.Response":{"type":"object","properties":{"code":{"type":"integer","format":"uint32","description":"Response status code"},"message":{"type":"string","description":"Response message"},"data":{"description":"Response data payload (can be any type)"},"meta":{"type":"object","additionalProperties":true,"description":"Additional metadata with dynamic keys"}}},"entity.OrderDetail":{"type":"object","properties":{"avg_price":{"type":"string"},"base_coin_precision":{"type":"integer"},"executed_amount":{"type":"string"},"filled_total":{"type":"string"},"history":{"type":"boolean"},"id":{"type":"string"},"order_amount":{"type":"string"},"order_cid":{"type":"string"},"order_id":{"type":"integer"},"order_price":{"type":"string"},"order_time":{"type":"string"},"order_total":{"type":"string"},"permission":{"type":"string"},"pool_base_coin":{"type":"string"},"pool_id":{"type":"integer"},"pool_quote_coin":{"type":"string"},"pool_symbol":{"type":"string"},"quote_coin_precision":{"type":"integer"},"side":{"type":"integer","description":"0 buy 1 sell"},"status":{"type":"integer","description":"0 open 1partially_filled 2 full_filled 3.canceled"},"trader":{"type":"string"},"trades":{"type":"array","items":{"$ref":"#/components/schemas/entity.TradeDetail"}},"type":{"type":"integer","description":"0 market 1 limit"},"unread":{"type":"boolean"}}},"entity.TradeDetail":{"type":"object","properties":{"base_coin":{"type":"string"},"base_quantity":{"type":"string"},"global_seq":{"type":"integer"},"maker":{"type":"string"},"maker_fee":{"type":"string"},"maker_order_cid":{"type":"string"},"maker_order_id":{"type":"integer"},"maker_permission":{"type":"string"},"pool_id":{"type":"integer"},"price":{"type":"string"},"quote_coin":{"type":"string"},"quote_quantity":{"type":"string"},"taker":{"type":"string"},"taker_fee":{"type":"string"},"taker_is_bid":{"type":"boolean"},"taker_order_cid":{"type":"string"},"taker_order_id":{"type":"integer"},"taker_permission":{"type":"string"},"timestamp":{"type":"string"},"tx_id":{"type":"string"}}}}},"paths":{"/api/v1/orders/{id}":{"get":{"tags":["Account Endpoints"],"summary":"Get history order detail","description":"Get history order detail","parameters":[{"name":"id","in":"path","description":"pool_id+order_id+side,ps:0-1-0 pool_id = 0,order_id = 1,side = buy","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"history order detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.Response","properties":{"data":{"$ref":"#/components/schemas/entity.OrderDetail"}}}}}}}}}}}
```

## Get order by client order ID

> Get order by client order ID (order\_cid)

```json
{"openapi":"3.0.1","info":{"title":"1dex api v1","version":"1.0"},"servers":[{"url":"https://api-v1.1dex.com"},{"url":"https://api-test-v1.1dex.com"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"api.Response":{"type":"object","properties":{"code":{"type":"integer","format":"uint32","description":"Response status code"},"message":{"type":"string","description":"Response message"},"data":{"description":"Response data payload (can be any type)"},"meta":{"type":"object","additionalProperties":true,"description":"Additional metadata with dynamic keys"}}},"entity.Order":{"type":"object","properties":{"avg_price":{"type":"string"},"base_coin_precision":{"type":"integer"},"executed_amount":{"type":"string"},"filled_total":{"type":"string"},"history":{"type":"boolean"},"id":{"type":"string"},"order_amount":{"type":"string"},"order_cid":{"type":"string"},"order_id":{"type":"integer"},"order_price":{"type":"string"},"order_time":{"type":"string"},"order_total":{"type":"string"},"permission":{"type":"string"},"pool_base_coin":{"type":"string"},"pool_id":{"type":"integer"},"pool_quote_coin":{"type":"string"},"pool_symbol":{"type":"string"},"quote_coin_precision":{"type":"integer"},"side":{"type":"integer","description":"0 buy 1 sell"},"status":{"type":"integer","description":"0 open 1partially_filled 2full_filled 3.canceled"},"trader":{"type":"string"},"type":{"type":"integer","description":"0 market 1 limit"},"unread":{"type":"boolean"}}}}},"paths":{"/api/v1/orders/client-id/{id}":{"get":{"tags":["Account Endpoints"],"summary":"Get order by client order ID","description":"Get order by client order ID (order_cid)","parameters":[{"name":"id","in":"path","description":"Client order ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"order","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.Response","properties":{"data":{"$ref":"#/components/schemas/entity.Order"}}}}}}}}}}}
```

## Get trades by subaccount

> Get recent trades for the authenticated subaccount

```json
{"openapi":"3.0.1","info":{"title":"1dex api v1","version":"1.0"},"servers":[{"url":"https://api-v1.1dex.com"},{"url":"https://api-test-v1.1dex.com"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"api.Response":{"type":"object","properties":{"code":{"type":"integer","format":"uint32","description":"Response status code"},"message":{"type":"string","description":"Response message"},"data":{"description":"Response data payload (can be any type)"},"meta":{"type":"object","additionalProperties":true,"description":"Additional metadata with dynamic keys"}}},"entity.TradeDetail":{"type":"object","properties":{"base_coin":{"type":"string"},"base_quantity":{"type":"string"},"global_seq":{"type":"integer"},"maker":{"type":"string"},"maker_fee":{"type":"string"},"maker_order_cid":{"type":"string"},"maker_order_id":{"type":"integer"},"maker_permission":{"type":"string"},"pool_id":{"type":"integer"},"price":{"type":"string"},"quote_coin":{"type":"string"},"quote_quantity":{"type":"string"},"taker":{"type":"string"},"taker_fee":{"type":"string"},"taker_is_bid":{"type":"boolean"},"taker_order_cid":{"type":"string"},"taker_order_id":{"type":"integer"},"taker_permission":{"type":"string"},"timestamp":{"type":"string"},"tx_id":{"type":"string"}}}}},"paths":{"/api/v1/trades":{"get":{"tags":["Account Endpoints"],"summary":"Get trades by subaccount","description":"Get recent trades for the authenticated subaccount","parameters":[{"name":"limit","in":"query","description":"limit count (default 50, max 100)","schema":{"type":"integer"}},{"name":"startTime","in":"query","description":"filter trades after this timestamp (Unix timestamp in seconds)","schema":{"type":"integer"}},{"name":"endTime","in":"query","description":"filter trades before this timestamp (Unix timestamp in seconds)","schema":{"type":"integer"}},{"name":"global_seq","in":"query","description":"filter trades with global sequence number greater than this value","schema":{"type":"integer"}},{"name":"sort","in":"query","description":"sort direction for timestamp (asc or desc, default desc)","schema":{"type":"string","enum":["asc","desc"]}}],"responses":{"200":{"description":"trade detail list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.Response","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/entity.TradeDetail"}}}}}}}}}}}}
```

## Get subaccount transfers

> Get transfer records between subaccount and main account

```json
{"openapi":"3.0.1","info":{"title":"1dex api v1","version":"1.0"},"servers":[{"url":"https://api-v1.1dex.com"},{"url":"https://api-test-v1.1dex.com"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"api.Response":{"type":"object","properties":{"code":{"type":"integer","format":"uint32","description":"Response status code"},"message":{"type":"string","description":"Response message"},"data":{"description":"Response data payload (can be any type)"},"meta":{"type":"object","additionalProperties":true,"description":"Additional metadata with dynamic keys"}}},"entity.SubAccountTransfer":{"type":"object","properties":{"amount":{"type":"string","description":"transfer amount"},"contract":{"type":"string","description":"token contract address"},"symbol":{"type":"string","description":"token symbol"},"from":{"type":"string","description":"sender address"},"to":{"type":"string","description":"receiver address"},"tx_id":{"type":"string","description":"transaction ID"},"side":{"type":"string","description":"transfer direction (in/out)"},"sid":{"type":"string","description":"subaccount ID"},"name":{"type":"string","description":"subaccount name"},"created_at":{"type":"string","format":"date-time","description":"transfer creation time"}}}}},"paths":{"/api/v1/transfers":{"get":{"tags":["Account Endpoints"],"summary":"Get subaccount transfers","description":"Get transfer records between subaccount and main account","parameters":[{"name":"limit","in":"query","description":"limit count","schema":{"type":"integer"}},{"name":"startTime","in":"query","description":"start time in Unix timestamp format (seconds since epoch)","schema":{"type":"integer"}},{"name":"endTime","in":"query","description":"end time in Unix timestamp format (seconds since epoch)","schema":{"type":"integer"}},{"name":"transfer_id","in":"query","description":"filter transfers with id greater than this value","schema":{"type":"integer"}},{"name":"sort","in":"query","description":"sort direction for created_at (asc or desc, default desc)","schema":{"type":"string","enum":["asc","desc"]}}],"responses":{"200":{"description":"transfer records with pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.Response","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/entity.SubAccountTransfer"}}}}}}}}}}}}
```