Get Pools by Token

This endpoint returns token pool data for a given deployer address (DEX). Supported chains: ethereum, polygon, optimism, arbitrum, base, avalanche.

Parameters

Parameter	Description	Type
chain_id	A keyword (i.e. "ethereum") or CAIP-2 identifier specifying the blockchain to query.	string
token_address	required A token address to filter pools by.	string
pair_address	Add a second token to then filter by a token pair.	string
from_timestamp	Retrieve pools that were created after this timestamp, inclusive (in seconds since the Unix epoch or ISO-8601 format).	date-time
to_timestamp	Retrieve pools that were created before this timestamp, inclusive (in seconds since the Unix epoch or ISO-8601 format).	date-time
order	The order in which to retrieve the results (either asc or desc).	string
limit	The maximum number of results to retrieve (default 100).	string

Response

Name	Type	Description
contract_address	text	The contract address of the DEX pool.
contract_version	text	The version of the exchange contract that the DEX pool belongs to (e.g. v1 or v2).
created_block_number	integer	The block number at which the DEX pool was created.
created_timestamp	timestamp without time zone	The timestamp at which the DEX pool was created.
creator_address	text	The address that initiated the pool creation transaction.
exchange_name	text	The name of the exchange that the DEX pool belongs to.
factory_address	text	The address of the factory that created the pool.
is_active	boolean	Whether the pool is active or not.
last_active_timestamp	timestamp	The date at which the account was last active (in ISO-8601 format).
metadata	json	Additional protocol-specific metadata for the pool.
token_addresses	ARRAY	A list of token addresses that the pool contains (can include NFT contract addresses for SudoSwap pools).

PythonNodecURL

import requests url = "https://api.transpose.io/dex/pools-by-token" headers = { 'Content-Type': 'application/json', 'X-API-KEY': 'BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG', } params = { "chain_id": "ethereum", "token_address": "0x6982508145454Ce325dDbE47a25d4ec3d2311933", } response = requests.get(url, headers=headers, params=params) print(response.text) print('Credits charged:', response.headers.get('X-Credits-Charged', None))

const https = require('https'); const querystring = require('querystring'); const params = { chain_id: "ethereum", token_address: "0x6982508145454Ce325dDbE47a25d4ec3d2311933", } var options = { hostname: 'api.transpose.io', path: '/dex/pools-by-token?' + querystring.stringify(params), method: 'GET', headers: { 'X-API-KEY': 'BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG' } }; var req = https.request(options, (res) => { console.log('Credits charged:', res.headers['x-credits-charged']); res.on('data', (d) => { process.stdout.write(d); }); }); req.on('error', (e) => { console.error(e); }); req.end();

curl -X GET \
    'https://api.transpose.io/dex/pools-by-token?chain_id=ethereum&token_address=0x6982508145454Ce325dDbE47a25d4ec3d2311933' \
    -H 'X-API-KEY: BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG' \

Got questions? Join our Discord

Discord is the primary home of the Transpose developer community. Join us to ask questions, share your work, and get help.