get https://api.blockvision.org/v2/monad/token/trades
Retrieve a paginated list of token trades from the decentralized exchange (DEX). Each record contains detailed information about the swap.
Supported on Monad Testnet.
The Token Trades API on Monad is currently available to our paid Members. Free tier members can also enjoy a trial period with 30 free calls. If you're interested, please register directly through here. Please note that the API Key can also be used for your RPC endpoint.
Parameter
contractAddress
,string
- a 42 character address with '0x' as prefix. The on-chain address of the token’s smart contract.sender
,string
, - address of the trade sender.type
,string
, - trade type or action descriptor (e.g.,"buy,sell"
).cursor
,string
- next page cursor.limit
,integer
- the maximum number of results to return per page. Defaults to 20, maximum is 50.
Response
data
,array
- A list of trading transaction records.txHash
,string
- Transaction hash, unique identifier on the blockchain.sender
,string
- Wallet address of the user who initiated the transaction.type
,string
- Type of transaction, either"buy"
or"sell"
.dex
,string
- Name of the decentralized exchange where the transaction took place (e.g.,"Octo"
,"UniswapV3"
,"Bean Exchange"
).timestamp
,integer
- Unix timestamp in seconds when the transaction occurred.poolAddress
,string
- Contract address of the liquidity pool used for the swap.price
,string
- The effective price of the trade, calculated from token amounts.token0Info
,object
- Detailed information about the first token in the pair.token
,string
- Token contract address.amount
,string
- Token amount in human-readable format (decimals applied).amountUSD
,string
- USD value equivalent of the token amount.decimal
,integer
- Number of decimal places used by the token.name
,string
- Full name of the token.symbol
,string
- Token symbol (e.g.,"CHOG"
,"WMON"
,"WETH"
).image
,string
- URL to the token's logo image.verified
,boolean
- Whether the token has been verified.
token1Info
,object
- Detailed information about the second token in the pair, with the same structure as token0Info.token
,string
- Token contract address.amount
,string
- Token amount in human-readable format (decimals applied).amountUSD
,string
- USD value equivalent of the token amount.decimal
,integer
- Number of decimal places used by the token.name
,string
- Full name of the token.symbol
,string
- Token symbol.image
,string
- URL to the token's logo image.verified
,boolean
- Whether the token has been verified.
nextPageCursor
,integer
- Cursor used for paginating to the next page of results.