# Tokens

## token price by token-id (100 CU)

> token price information for up to 200 tokens

```json
{"openapi":"3.0.3","info":{"title":"Ave API (REST)","version":"2.1.0"},"servers":[{"url":"https://prod.ave-api.com"},{"url":"https://data.ave-api.xyz"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}}},"paths":{"/v2/tokens/price":{"post":{"summary":"token price by token-id (100 CU)","description":"token price information for up to 200 tokens","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token_ids":{"type":"array","description":"Array of token-id in format `<token_address>-<chain>` (max 200)","items":{"type":"string"},"maxItems":200},"tvl_min":{"type":"integer","description":"minimum TVL (default: 1000, 0 means no threshold)","default":1000},"tx_24h_volume_min":{"type":"integer","description":"minimum 24h tx volume (default: 0, 0 means no threshold)","default":0}},"required":["token_ids"]}}}},"responses":{"200":{"description":"successful response with token prices","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad request"},"401":{"description":"unauthorized (missing or invalid API key)"},"403":{"description":"forbidden (API key expired)"},"500":{"description":"server error"}}}}}}
```

## POST /v2/tokens/search

> batch token detail by token\_ids (100 CU)

```json
{"openapi":"3.0.3","info":{"title":"Ave API (REST)","version":"2.1.0"},"servers":[{"url":"https://prod.ave-api.com"},{"url":"https://data.ave-api.xyz"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}}},"paths":{"/v2/tokens/search":{"post":{"summary":"batch token detail by token_ids (100 CU)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token_ids":{"type":"array","description":"Array of token-id in format `<token_address>-<chain>` (max 50)","items":{"type":"string"},"maxItems":50}},"required":["token_ids"]}}}},"responses":{"200":{"description":"successful response with token search results","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad request"},"401":{"description":"unauthorized (missing or invalid API key)"},"403":{"description":"forbidden (API key expired)"},"500":{"description":"server error"}}}}}}
```

## GET /v2/tokens

> search for tokens by keyword (5 CU)

```json
{"openapi":"3.0.3","info":{"title":"Ave API (REST)","version":"2.1.0"},"servers":[{"url":"https://prod.ave-api.com"},{"url":"https://data.ave-api.xyz"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}}},"paths":{"/v2/tokens":{"get":{"summary":"search for tokens by keyword (5 CU)","parameters":[{"name":"keyword","in":"query","required":true,"description":"token symbol or token address (e.g. `TRUMP` or `6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN`)","schema":{"type":"string"}},{"name":"chain","in":"query","required":false,"description":"chain name (e.g. `solana`)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"number of results to return (default: 100, max: 300)","schema":{"type":"integer","default":100,"maximum":300}},{"name":"orderby","in":"query","required":false,"description":"sort field: default - `tx_volume_u_24h`, others - `market_cap`, `main_pair_tvl`, `fdv`","schema":{"type":"string","enum":["tx_volume_u_24h","market_cap","main_pair_tvl","fdv"],"default":"tx_volume_u_24h"}}],"responses":{"200":{"description":"successful response with matching tokens","content":{"application/json":{"schema":{"type":"array","items":{"type":"object"}}}}},"400":{"description":"bad request"},"401":{"description":"unauthorized (missing or invalid API key)"},"403":{"description":"forbidden (API key expired)"},"500":{"description":"server error"}}}}}}
```

## GET /v2/tokens/{token-id}

> token detail and top 5 pairs (5 CU)

```json
{"openapi":"3.0.3","info":{"title":"Ave API (REST)","version":"2.1.0"},"servers":[{"url":"https://prod.ave-api.com"},{"url":"https://data.ave-api.xyz"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}},"schemas":{"TokenApiResponse":{"type":"object","properties":{"status":{"type":"integer"},"msg":{"type":"string"},"data_type":{"type":"integer"},"data":{"type":"object","properties":{"is_audited":{"type":"boolean"},"pairs":{"type":"array","items":{"$ref":"#/components/schemas/TokenPair"}},"token":{"$ref":"#/components/schemas/TokenInfo"}}}}},"TokenPair":{"type":"object","properties":{"amm":{"type":"string"},"chain":{"type":"string"},"pair":{"type":"string"},"price_change":{"type":"string"},"price_change_24h":{"type":"string"},"token0_symbol":{"type":"string"},"token1_symbol":{"type":"string"},"token0_price_usd":{"type":"string"},"token1_price_usd":{"type":"string"},"volume_u":{"type":"string"},"updated_at":{"type":"integer"}}},"TokenInfo":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"chain":{"type":"string"},"current_price_usd":{"type":"string"},"market_cap":{"type":"string"},"holders":{"type":"integer"},"tvl":{"type":"string"},"logo_url":{"type":"string"},"updated_at":{"type":"integer"}}}}},"paths":{"/v2/tokens/{token-id}":{"get":{"summary":"token detail and top 5 pairs (5 CU)","parameters":[{"name":"token-id","in":"path","required":true,"description":"token address and chain in format `<token_address>-<chain>` (e.g. `6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN-solana`)","schema":{"type":"string"}}],"responses":{"200":{"description":"successful response with token info and pairs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenApiResponse"}}}},"400":{"description":"bad request"},"401":{"description":"unauthorized (missing or invalid API key)"},"403":{"description":"forbidden (API key expired)"},"500":{"description":"server error"}}}}}}
```

## GET /v2/contracts/{token-id}

> token risk information (10 CU)

```json
{"openapi":"3.0.3","info":{"title":"Ave API (REST)","version":"2.1.0"},"servers":[{"url":"https://prod.ave-api.com"},{"url":"https://data.ave-api.xyz"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}}},"paths":{"/v2/contracts/{token-id}":{"get":{"summary":"token risk information (10 CU)","parameters":[{"name":"token-id","in":"path","required":true,"description":"token address and chain in format `<token_address>-<chain>` (e.g. `6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN-solana`)","schema":{"type":"string"}}],"responses":{"200":{"description":"successful response with contract and risk info","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad request"},"401":{"description":"unauthorized (missing or invalid API key)"},"403":{"description":"forbidden (API key expired)"},"500":{"description":"server error"}}}}}}
```

## GET /v2/tokens/top100/{token-id}

> top 100 holders of the token (10 CU)

```json
{"openapi":"3.0.3","info":{"title":"Ave API (REST)","version":"2.1.0"},"servers":[{"url":"https://prod.ave-api.com"},{"url":"https://data.ave-api.xyz"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}},"schemas":{"TokenHolder":{"type":"object","properties":{"holder":{"type":"string"},"balance_ratio":{"type":"number"},"balance_usd":{"type":"number"},"main_coin_balance":{"type":"number"},"address":{"type":"string"},"amount_cur":{"type":"number"}},"required":["holder","balance_ratio","balance_usd","main_coin_balance","address","amount_cur"]}}},"paths":{"/v2/tokens/top100/{token-id}":{"get":{"summary":"top 100 holders of the token (10 CU)","parameters":[{"name":"token-id","in":"path","required":true,"description":"token address and chain in format `<token_address>-<chain>` (e.g. `6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN-solana`)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"number of holders to return (default: 100, max: 100)","schema":{"type":"integer","default":100,"maximum":100}}],"responses":{"200":{"description":"successful response with top holders","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TokenHolder"}}}}},"400":{"description":"bad request"},"401":{"description":"unauthorized (missing or invalid API key)"},"403":{"description":"forbidden (API key expired)"},"500":{"description":"server error"}}}}}}
```

## GET /v2/tokens/main

> main tokens on the chain (5 CU)

```json
{"openapi":"3.0.3","info":{"title":"Ave API (REST)","version":"2.1.0"},"servers":[{"url":"https://prod.ave-api.com"},{"url":"https://data.ave-api.xyz"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}},"schemas":{"MainToken":{"type":"object","properties":{"token":{"type":"string"},"chain":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"current_price_usd":{"type":"string"},"market_cap":{"type":"string"},"holders":{"type":"integer"},"tvl":{"type":"string"},"logo_url":{"type":"string"},"updated_at":{"type":"integer"}},"required":["token","chain","name","symbol","current_price_usd","market_cap","holders","logo_url","updated_at"]}}},"paths":{"/v2/tokens/main":{"get":{"summary":"main tokens on the chain (5 CU)","parameters":[{"name":"chain","in":"query","required":true,"description":"chain name (e.g. `solana`)","schema":{"type":"string"}}],"responses":{"200":{"description":"successful response with main tokens","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MainToken"}}}}},"400":{"description":"bad request"},"401":{"description":"unauthorized (missing or invalid API key)"},"403":{"description":"forbidden (API key expired)"},"500":{"description":"server error"}}}}}}
```

## GET /v2/tokens/trending

> trending tokens on the chain (5 CU)

```json
{"openapi":"3.0.3","info":{"title":"Ave API (REST)","version":"2.1.0"},"servers":[{"url":"https://prod.ave-api.com"},{"url":"https://data.ave-api.xyz"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}}},"paths":{"/v2/tokens/trending":{"get":{"summary":"trending tokens on the chain (5 CU)","parameters":[{"name":"chain","in":"query","required":true,"description":"chain name (e.g. `bsc`)","schema":{"type":"string"}},{"name":"current_page","in":"query","required":false,"description":"page number (default: 0)","schema":{"type":"integer","default":0}},{"name":"page_size","in":"query","required":false,"description":"number of tokens per page (default: 50, max: 100)","schema":{"type":"integer","default":50,"maximum":100}}],"responses":{"200":{"description":"successful response with trending tokens","content":{"application/json":{"schema":{"type":"object","properties":{"current_page_size":{"type":"integer"},"next_page":{"type":"integer"},"tokens":{"type":"array","items":{"type":"object"}}}}}}},"400":{"description":"bad request"},"401":{"description":"unauthorized (missing or invalid API key)"},"403":{"description":"forbidden (API key expired)"},"500":{"description":"server error"}}}}}}
```

## GET /v2/tokens/platform

> tokens by launch platform (10 CU)

```json
{"openapi":"3.0.3","info":{"title":"Ave API (REST)","version":"2.1.0"},"servers":[{"url":"https://prod.ave-api.com"},{"url":"https://data.ave-api.xyz"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}}},"paths":{"/v2/tokens/platform":{"get":{"summary":"tokens by launch platform (10 CU)","parameters":[{"name":"tag","in":"query","required":true,"description":"platform tag to filter tokens (e.g. `meme`, `pump_in_hot`, `pump_in_new`, `pump_out_hot`, `pump_out_new`)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"number of results to return (default: 100, max: 300)","schema":{"type":"integer","default":100,"maximum":300}},{"name":"orderby","in":"query","required":false,"description":"sort field: default -`tx_volume_u_24h`, others - `main_pair_tvl`","schema":{"type":"string","enum":["tx_volume_u_24h","main_pair_tvl"],"default":"tx_volume_u_24h"}}],"responses":{"200":{"description":"successful response with tokens by tag","content":{"application/json":{"schema":{"type":"array","items":{"type":"object"}}}}},"400":{"description":"bad request"},"401":{"description":"unauthorized (missing or invalid API key)"},"403":{"description":"forbidden (API key expired)"},"500":{"description":"server error"}}}}}}
```

## GET /v2/pairs/{pair-id}

> pair detail (5 CU)

```json
{"openapi":"3.0.3","info":{"title":"Ave API (REST)","version":"2.1.0"},"servers":[{"url":"https://prod.ave-api.com"},{"url":"https://data.ave-api.xyz"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}}},"paths":{"/v2/pairs/{pair-id}":{"get":{"summary":"pair detail (5 CU)","parameters":[{"name":"pair-id","in":"path","required":true,"description":"pair address and chain in format `<pair_address>-<chain>` (e.g. `2prhzdRwWzas2f4g5AAjyRUBcQcdajxd8NAzKcqhv76P-solana`)","schema":{"type":"string"}}],"responses":{"200":{"description":"successful response with pair info","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"bad request"},"401":{"description":"unauthorized (missing or invalid API key)"},"403":{"description":"forbidden (API key expired)"},"500":{"description":"server error"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ave-cloud.gitbook.io/data-api/rest/tokens.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.