v2

Get Your API Key

Please visit https://cloud.ave.ai/register to sign up for a new account and get your free API Key. To upgrade your API Key plan, join the https://t.me/ave_ai_cloud telegram group to follow the instructions.

All API request need the following header present

Name
Type
Description

X-API-KEY*

string

Your API key needed to access the url

Search Token

Search for the tokens associated with the given keyword

GET https://prod.ave-api.com/v2/tokens?keyword={keyword}

The keyword must not be null or empty, search by SYMBOL or CONTRACT ADDRESS, and will return max 300 tokens.

NOTE:

The following fields are not in use. Please use the Contract Risk Detection Report API instead.

has_mint_method, is_lp_not_locked, has_not_renounced, 
has_not_audited, has_not_open_source, is_in_blacklist, 
is_honeypot, ave_risk_level

Query Parameters

Name
Type
Description

keyword*

string

The keyword needed to query

chain

string

Chain name

limit

int

Default: 100, Max 300

orderby

string

tx_volume_u_24h, main_pair_tvl, fdv, market_cap

Response Body

Get Token Prices

POST https://prod.ave-api.com/v2/tokens/price

Request Body

Name
Type
Description

token_ids*

array of string

list of token ids, max 200 token ids

tvl_min

int

token min tvl threshold to include into search result

(default: 1000, 0 means no threshold)

tx_24h_volume_min

int

token min 24 hour volume threshold to include into search result (default: 0, 0 means no threshold)

Response Body

Get Token Rank Topics

GET https://prod.ave-api.com/v2/ranks/topics

Response Body

Get Rank Token List By Topic

GET https://prod.ave-api.com/v2/ranks?topic={topic}

Query Parameters

Name
Type
Description

topic*

string

topic in rank topics

limit

int

Default: 200, Max: 300

Response Body

Get Token Detail

GET https://prod.ave-api.com/v2/tokens/{token-id}

Query Path

Name
Type
Description

token_id*

string

token_id = {token}-{chain} eg: 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN-solana

Response Body

Get Kine Data By Pair

GET https://prod.ave-api.com/v2/klines/pair/{pair-id}?interval={interval}&size={size}

Query Path & Parameters

Name
Type
Description

pair_id*

string

pair_id = {pair}-{chain} eg: 2prhzdRwWzas2f4g5AAjyRUBcQcdajxd8NAzKcqhv76P-solana

category

string

default is u u refers to target token USDT price r refers to target token to base token relative price m refers to target token to main token relative price

interval

int

The time interval of K-Line, 1,5,15,30,60,120,240,1440,4320,10080,43200,525600,2628000

limit

int

The number of records need to return

from_time

int

start time in unix epoch, default -1

to_time

int

end time in unix epoch, default now

Response Body

Get Kine Data By Token

GET https://prod.ave-api.com/v2/klines/token/{token-id}?interval={interval}&size={size}

Query Path & Parameters

Name
Type
Description

token_id*

string

token_id = {token}-{chain} eg: 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN-solana

interval

int

The time interval of K-Line in minutes:

1,5,15,30,60,120,240,1440,4320,10080,43200,525600,2628000

limit

int

The number of records need to return

from_time

int

start time in unix epoch, default -1

to_time

int

end time in unix epoch, default now

Response Body

Get Token Top100 Holders

GET https://prod.ave-api.com/v2/tokens/top100/{token-id}

Query Path & Parameters

Name
Type
Description

token_id*

string

token_id = {token}-{chain} eg: 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN-solana

limit

int

Default: 100, Max: 100 NOTE: this param always 100 for bsc and solana chain

Response Body

Get Swap Transactions By Pair

GET https://prod.ave-api.com/v2/txs/{pair-id}?limit={limit}&size={size}&to_time={to_time}

Query Parameters

Name
Type
Description

pair_id*

string

pair_id = {pair}-{chain} eg: 2prhzdRwWzas2f4g5AAjyRUBcQcdajxd8NAzKcqhv76P-solana

limit

int

The number of records need to return

from_time

int

start time in unix epoch, default -1

to_time

int

end time in unix epoch, default now

sort

string

asc, desc Default: asc

Response Body

Get Supported Chains

GET https://prod.ave-api.com/v2/supported_chains

Response Body

Get Chain Main Tokens

GET https://prod.ave-api.com/v2/tokens/main?chain={chain_name}

Response Body

GET https://prod.ave-api.com/v2/tokens/trending?chain={chain_name}

Query Parameters

Name
Type
Description

chain*

string

chain name

current_page

int

Default: 0, Start from 0

page_size

int

Default: 50

Response Body

Get Contract Risk Detection Report

GET https://prod.ave-api.com/v2/contracts/{token-id}

Query Path

Params
Description

token_id*

token_id = {token}-{chain} eg:

Response Body

Last updated