4/25/24, 7:33 PM Reference | DEX Screener - Docs

DEX Screener - Docs

Reference
DEX Screener API reference
This API is still in beta and endpoints/types may change in the future

API calls are limited to 300 requests per minute

Pairs
Get one or multiple pairs by chain and pair
address
GET https://api.dexscreener.com/latest/dex/pairs/:chainId/:pairAddresses

Try this endpoint here 🤞🏼

Path Parameters
Name Type Description
chainId* string ethereum | bsc | polygon | etc..
One or multiple, comma-separated
pairAddresses* string[] pair addresses (up to 30 addresses)
E.g.: 0xAbc1 or 0xAbc1,0xAbc2,0xAbc3
String

200: OK
https://docs.dexscreener.com/api/reference 1/7
4/25/24, 7:33 PM Reference | DEX Screener - Docs

interface PairsResponse {
schemaVersion: string;
/** @deprecated use pairs field instead */
pair: Pair | null;
pairs: Pair[] | null;
}

Request Response

https://api.dexscreener.io/latest/dex/pairs/bsc/0x7213a321F1855CF1779f
42c0CD85d3D95291D34C,
0x16b9a82891338f9ba80e2d6970fdda79d1eb0dae

Tokens
Get one or multiple pairs by token address
GET https://api.dexscreener.com/latest/dex/tokens/:tokenAddreses

Try this endpoint here 🤞🏼

Path Parameters
Name Type Description
One or multiple, comma-separated
tokenAddresses string[] token addresses (up to 30 addresses)
*
E.g.: 0xAbc1 or 0xAbc1,0xAbc2,0xAbc3

200: OK
interface TokensResponse {
schemaVersion: string;
pairs: Pair[] | null;
}

https://docs.dexscreener.com/api/reference 2/7
4/25/24, 7:33 PM Reference | DEX Screener - Docs

Request Sample Response

https://api.dexscreener.io/latest/dex/tokens/0x2170Ed0880ac9A755fd29B2
688956BD959F933F8,
0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c

Search
Search for pairs matching query
GET https://api.dexscreener.com/latest/dex/search/?q=:q

Query may include pair address, token address, token name or token symbol.
Try this endpoint here 🤞🏼
Path Parameters
Name Type Description
query
q* String
E.g.: WBTC or WBTC/USDC or 0xAbc01

200: OK
interface SearchResponse {
schemaVersion: string;
pairs: Pair[];
}

Request Response

https://docs.dexscreener.com/api/reference 3/7
4/25/24, 7:33 PM Reference | DEX Screener - Docs

https://api.dexscreener.io/latest/dex/search?q=WBNB%20USDC

Pair type

https://docs.dexscreener.com/api/reference 4/7
4/25/24, 7:33 PM Reference | DEX Screener - Docs

https://docs.dexscreener.com/api/reference 5/7
4/25/24, 7:33 PM Reference | DEX Screener - Docs

interface Pair {
chainId: string;
dexId: string;
url: string;
pairAddress: string;
baseToken: {
address: string;
name: string;
symbol: string;
};
quoteToken: {
symbol: string;
};
priceNative: string;
priceUsd?: string;
txns: {
m5: {
buys: number;
sells: number;
};
h1: {
buys: number;
sells: number;
};
h6: {
buys: number;
sells: number;
};
h24: {
buys: number;
sells: number;
};
};
volume: {
m5: number;
h1: number;
h6: number;
h24: number;
};
priceChange: {
m5: number;
h1: number;
h6: number;
h24: number;
};
liquidity?: {
usd?: number;
base: number;
quote: number;
https://docs.dexscreener.com/api/reference 6/7
4/25/24, 7:33 PM Reference | DEX Screener - Docs
quote: number;
};
fdv?: number;
pairCreatedAt?: number;
}

Last updated 1 year ago

https://docs.dexscreener.com/api/reference 7/7