Get Token Swaps by Contract Address

This endpoint returns all Token Swaps that occurred within the given date range (supports pagination). Supported chains: ethereum, polygon, optimism, arbitrum, avalanche.

Parameters

Parameter	Description	Type
chain_id	A keyword (i.e. "ethereum") or CAIP-2 identifier specifying the blockchain to query.	string
contract_address	required The contract address of the token to retrieve swaps for (supports ENS names).	string
direction	The direction of the swaps to fetch (either from, to, or all).	string
occurred_after	The earlier swap date, inclusive (in seconds since the Unix epoch or ISO-8601 format).	date-time
occurred_before	The later swap date, 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

PythonNodecURL

import requests url = "https://api.transpose.io/token/swaps-by-contract-address" headers = { 'Content-Type': 'application/json', 'X-API-KEY': 'BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG', } params = { "chain_id": "ethereum", "contract_address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", } 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", contract_address: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", } var options = { hostname: 'api.transpose.io', path: '/token/swaps-by-contract-address?' + 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/token/swaps-by-contract-address?chain_id=ethereum&contract_address=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2' \
    -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.