> 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/general-endpoints.md).

# General Endpoints

## Ping

> Ping

```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"}],"paths":{"/api/v1/ping":{"get":{"tags":["General endpoints"],"summary":"Ping","description":"Ping","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.Response","properties":{"data":{"type":"object","properties":{"timestamp":{"type":"integer","description":"timestamp"}}}}}}}}}}}},"components":{"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"}}}}}}
```

## Get system information

> Get system information

```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"}],"paths":{"/api/v1/system-info":{"get":{"tags":["General endpoints"],"summary":"Get system information","description":"Get system information","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.Response","properties":{"data":{"$ref":"#/components/schemas/entity.RespSystemInfo"}}}}}}}}}},"components":{"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.RespSystemInfo":{"type":"object","properties":{"app_contract":{"type":"string"},"pay_eos_account":{"type":"string"},"token_contract":{"type":"string"},"version":{"type":"string"}}}}}}
```

## List all trading pools

> Get a list of all trading pools

```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"}],"paths":{"/api/v1/pools":{"get":{"tags":["General endpoints"],"summary":"List all trading pools","description":"Get a list of all trading pools","parameters":[{"name":"base_coin","in":"query","description":"base coin","schema":{"type":"string"}},{"name":"quote_coin","in":"query","description":"quote coin","schema":{"type":"string"}}],"responses":{"200":{"description":"pool info","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.Response","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/entity.PoolStats"}}}}}}}}}}},"components":{"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.PoolStats":{"type":"object","properties":{"base_coin":{"type":"string"},"base_coin_precision":{"type":"integer"},"change":{"type":"string"},"change_rate":{"type":"number"},"high":{"type":"string"},"last_price":{"type":"string"},"low":{"type":"string"},"pool_id":{"type":"integer"},"price_precision":{"type":"integer"},"quote_coin":{"type":"string"},"quote_coin_precision":{"type":"integer"},"symbol":{"type":"string"},"trades":{"type":"integer"},"turnover":{"type":"string"},"updated_at":{"type":"string"},"volume":{"type":"string"}}}}}}
```

## Get pool details

> Get detailed information about a specific trading pool

```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"}],"paths":{"/api/v1/pools/{symbolOrId}":{"get":{"tags":["General endpoints"],"summary":"Get pool details","description":"Get detailed information about a specific trading pool","parameters":[{"name":"symbolOrId","in":"path","description":"pool symbol or pool id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.Response","properties":{"data":{"$ref":"#/components/schemas/entity.Pool"}}}}}}}}}},"components":{"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.Pool":{"type":"object","properties":{"asking_time":{"type":"string"},"base_coin":{"type":"string"},"base_coin_precision":{"type":"integer"},"base_contract":{"type":"string"},"base_symbol":{"type":"string"},"maker_fee_rate":{"type":"number"},"max_flct":{"type":"integer"},"min_amount":{"type":"string"},"pool_id":{"type":"integer"},"pool_stats":{"$ref":"#/components/schemas/entity.PoolStats"},"price_precision":{"type":"integer"},"quote_coin":{"type":"string"},"quote_coin_precision":{"type":"integer"},"quote_contract":{"type":"string"},"quote_symbol":{"type":"string"},"status":{"type":"integer"},"symbol":{"type":"string"},"taker_fee_rate":{"type":"number"},"trading_time":{"type":"string"}}},"entity.PoolStats":{"type":"object","properties":{"base_coin":{"type":"string"},"base_coin_precision":{"type":"integer"},"change":{"type":"string"},"change_rate":{"type":"number"},"high":{"type":"string"},"last_price":{"type":"string"},"low":{"type":"string"},"pool_id":{"type":"integer"},"price_precision":{"type":"integer"},"quote_coin":{"type":"string"},"quote_coin_precision":{"type":"integer"},"symbol":{"type":"string"},"trades":{"type":"integer"},"turnover":{"type":"string"},"updated_at":{"type":"string"},"volume":{"type":"string"}}}}}}
```

## Get support tokens

> Get support tokens

```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"}],"paths":{"/api/v1/tokens":{"get":{"tags":["General endpoints"],"summary":"Get support tokens","description":"Get support tokens","responses":{"200":{"description":"token list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.Response","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/entity.Token"}}}}}}}}}}},"components":{"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.Token":{"type":"object","properties":{"decimals":{"type":"integer"},"eos_contract":{"type":"string"},"exsat_decimals":{"type":"integer"},"exsat_token_address":{"type":"string"},"icon_url":{"type":"string"},"info":{"$ref":"#/components/schemas/entity.TokenInfo"},"name":{"type":"string"},"support_chain":{"type":"array","items":{"$ref":"#/components/schemas/entity.Chain"}},"symbol":{"type":"string"}}},"entity.TokenInfo":{"type":"object","properties":{"circulating_supply":{"type":"string"},"fully_diluted_market_cap":{"type":"string"},"historical_high":{"type":"string"},"historical_high_date":{"type":"string"},"historical_low":{"type":"string"},"historical_low_date":{"type":"string"},"intro":{"type":"string"},"issue_date":{"type":"string"},"links":{"type":"array","items":{"$ref":"#/components/schemas/entity.TokenLink"}},"market_capitalization":{"type":"string"},"market_dominance":{"type":"string"},"maximum_supply":{"type":"string"},"rank":{"type":"string"},"total_supply":{"type":"string"},"volume":{"type":"string"},"volume_div_market_cap":{"type":"string"}}},"entity.TokenLink":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"}}},"entity.Chain":{"type":"object","properties":{"chain_id":{"type":"integer"},"chain_name":{"type":"string"},"exsat_withdraw_fee":{"type":"string"},"min_deposit_amount":{"type":"string"},"min_withdraw_amount":{"type":"string"},"permission_id":{"type":"integer"},"withdraw_fee":{"type":"string"}}}}}}
```

## Get token info

> Get token 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"}],"paths":{"/api/v1/token/{symbol}":{"get":{"tags":["General endpoints"],"summary":"Get token info","description":"Get token info","parameters":[{"name":"symbol","in":"path","description":"coin symbol,ps BTC","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"token info","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.Response","properties":{"data":{"$ref":"#/components/schemas/entity.Token"}}}}}}}}}},"components":{"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.Token":{"type":"object","properties":{"decimals":{"type":"integer"},"eos_contract":{"type":"string"},"exsat_decimals":{"type":"integer"},"exsat_token_address":{"type":"string"},"icon_url":{"type":"string"},"info":{"$ref":"#/components/schemas/entity.TokenInfo"},"name":{"type":"string"},"support_chain":{"type":"array","items":{"$ref":"#/components/schemas/entity.Chain"}},"symbol":{"type":"string"}}},"entity.TokenInfo":{"type":"object","properties":{"circulating_supply":{"type":"string"},"fully_diluted_market_cap":{"type":"string"},"historical_high":{"type":"string"},"historical_high_date":{"type":"string"},"historical_low":{"type":"string"},"historical_low_date":{"type":"string"},"intro":{"type":"string"},"issue_date":{"type":"string"},"links":{"type":"array","items":{"$ref":"#/components/schemas/entity.TokenLink"}},"market_capitalization":{"type":"string"},"market_dominance":{"type":"string"},"maximum_supply":{"type":"string"},"rank":{"type":"string"},"total_supply":{"type":"string"},"volume":{"type":"string"},"volume_div_market_cap":{"type":"string"}}},"entity.TokenLink":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"}}},"entity.Chain":{"type":"object","properties":{"chain_id":{"type":"integer"},"chain_name":{"type":"string"},"exsat_withdraw_fee":{"type":"string"},"min_deposit_amount":{"type":"string"},"min_withdraw_amount":{"type":"string"},"permission_id":{"type":"integer"},"withdraw_fee":{"type":"string"}}}}}}
```