Get Swaps by Timestamp

This endpoint returns swap data for a given decentralized exchange (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
exchange_name	The name of the decentralized exchange.	string
contract_version	The version of the particular exchange contract.	string
from_timestamp	The earlier timestamp to retrieve swap data between, inclusive (in seconds since the Unix epoch or ISO-8601 format).	date-time
to_timestamp	The later timestamp to retrieve swap data between, 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

Supported Protocols

Protocol
03-swap-v1	03-swap-v10	03-swap-v11	03-swap-v12
03-swap-v13	03-swap-v14	03-swap-v15	03-swap-v16
03-swap-v17	03-swap-v18	03-swap-v19	03-swap-v2
03-swap-v20	03-swap-v3	03-swap-v4	03-swap-v5
03-swap-v6	03-swap-v7	03-swap-v8	03-swap-v9
0x-v1	0x-v2	0x-v3	1inch-v1
1inch-v10	1inch-v11	1inch-v12	1inch-v2
1inch-v3	1inch-v4	1inch-v5	1inch-v6
1inch-v7	1inch-v8	1inch-v9	afro-dex-v1
airswap-legacy	airswap-v1	airswap-v2	airswap-v3
ambient-v1	apeswap-v2	atomic-blue-v1	atomic-blue-v2
az-exchange-v1	balancer-v1	balancer-v1-forks	balancer-v2
bananagun-v1	bancor-v1	bancor-v2	bean-dex-v1
bebop-v1	bitcratic-v1	bitcratic-v2	bitox-io-v1
bzx-v1	cityswap-v1	clipper-v1	coin-change-ex-v1
coinbase-v1	collection-v1	collection-v2	cowswap-v1
cowswap-v2	cowswap-v3	cryptlo-v2	curve-lending
curve-metapool	curve-tricrypto	curve-v1	curve-v2
ddex-hybrid	ddex-hydro	decentrex-v1	decentrex-v2
decentrex-v3	defi-swap-v1	dex-ag-v1	dex-ag-v2
dex-ag-v3	dex-ag-v4	dex-blue-v1	dfx-v1
dfx-v2	dodo-v1	dodo-v2	dodoswap-private
dodoswap-stable	dodoswap-v1	dodoswap-v2	dutchx-v1
e-dex-v1	elasticswap-v1	enclaves-v1	ether-next-v1
etherdelta-1-forks	etherdelta-v1	etherdelta-v2	etherdelta-v3
etherdelta-v4	etherdelta-v5	ethmall-v1	ex-toke-v1
firebird-v1	fraxswap-v1	fraxswap-v2	genieswap-v1
genieswap-v2	genieswap-v3	hashflow-v1	hashflow-v2
kyber-v1	kyber-v2	kyber-v3	makerdao-psm
market-place-v1	maverick-v1	miniswap-v1	mistx-v1
mstable-v1	n-dex-market-v1	oasis-v1	odos-v1
open-ocean-v1	open-ocean-v2	pancakeswap-mm	pancakeswap-v2
pancakeswap-v3	paraswap-v1	paraswap-v2	paraswap-v3
paraswap-v4	paraswap-v5	paraswap-v6	paraswap-v7
pendle-v2	polaris-dex-v1	saddle-finance-metapool	saddle-finance-stableswap
sakeswap-v1	sashimiswap-v1	seed_dex-v1	seed_dex-v2
shibaswap-v2	singular-x-v1	smoothyswap-v1	solidly-v1
solidly-v1-forks	sudoswap-v1	sudoswap-v2	sushiswap-v1
sushiswap-v3	synapse-v1	synthetix-v1	tokenlon-v1
tokenlon-v2	tokenlon-v3	tokenlon-v4	tokenlon-v5
tokenstore-v1	tokenstore-v1-forks	tradex-one-v1	unibot-v1
unicly-v1	uniswap-v1	uniswap-v2	uniswap-v2-forks
uniswap-v3	uniswap-v3-forks	uniswap-x	unitrade-v1
unsheth-v2	vanilla-v1	xy-finance-v1	zeedex-v1
zeedex-v2	zerion-v1	zerion-v2	zkswap-v1
zkswap-v2

Response

Name	Type	Description
aggregator_name	text	The name of the DEX aggregator that facilitated the DEX swap (null if not found).
block_number	integer	The block number at which the DEX swap occurred.
contract_address	text	The contract address of the pool that facilitated the DEX swap.
contract_version	text	The version of the exchange contract (e.g. v1 or v2).
effective_price	numeric	The price of the to-token denominated by the from-token (i.e. quantity_out / quantity_in).
exchange_name	text	The name of the exchange that facilitated the DEX swap.
from_token_address	text	The address of the token that was swapped in.
log_index	integer	The log index at which the DEX swap occurred.
origin_address	text	The address that submitted the transaction that contained the swap.
quantity_in	numeric	The amount of the token that was swapped in.
quantity_out	numeric	The amount of the token that was swapped out.
sender_address	text	The address that sent the tokens to the pool in the swap.
timestamp	timestamp without time zone	The timestamp at which the DEX swap occurred.
to_token_address	text	The address of the token that was swapped out.
transaction_hash	text	The transaction hash at which the DEX swap occurred.

PythonNodecURL

import requests url = "https://api.transpose.io/dex/swaps-by-timestamp" headers = { 'Content-Type': 'application/json', 'X-API-KEY': 'BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG', } params = { "chain_id": "ethereum", "from_timestamp": "2023-01-01", "to_timestamp": "2023-02-02", } 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", from_timestamp: "2023-01-01", to_timestamp: "2023-02-02", } var options = { hostname: 'api.transpose.io', path: '/dex/swaps-by-timestamp?' + 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/swaps-by-timestamp?chain_id=ethereum&from_timestamp=2023-01-01&to_timestamp=2023-02-02' \
    -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.