Skip to main content
GET
/
1
/
market
/
trades
/
pair
Get market trades
curl --request GET \
  --url https://explorer-api.mobula.io/api/1/market/trades/pair
{
  "data": [
    {
      "blockchain": "<string>",
      "hash": "<string>",
      "pair": "<string>",
      "date": 123,
      "token_price_vs": 123,
      "token_price": 123,
      "token_amount": 123,
      "token_amount_vs": 123,
      "token_amount_usd": 123,
      "type": "<string>",
      "sender": "<string>",
      "transaction_sender_address": "<string>",
      "token_amount_raw": "<string>",
      "token_amount_raw_vs": "<string>",
      "operation": "<string>"
    }
  ]
}

​
Query Details

  • For a specific pool: provide its pair/pool contract address in the address field.
  • For an asset: use the Market Asset Query format with the asset name or token address. The endpoint will resolve it to the most active pair.
ParameterTypeDescription
blockchainstringBlockchain name or ID, formatted as "evm:1" for Ethereum mainnet or "evm:56" for Binance Smart Chain.
assetstringAsset name or token contract address to resolve the most active pair automatically.
addressstringSpecific pair or pool contract address to query trades for.
symbolstringToken ticker symbol (optional alternative to asset).
limitnumberMaximum number of trade records to return.
amountnumberMinimum trade amount filter (optional).
sortBystringField to sort the results by (e.g., amount_usd, date).
sortOrderSort order: "asc" for ascending or "desc" for descending.
offsetnumberPagination offset to skip a number of trade records.
modeMode of querying (e.g., "asset", "pair").
transactionSenderAddressstringFilter trades initiated by a specific transaction sender address.
​

​
Usage Examples

  • Query by Pool Address and Specific Sender Address
curl -X GET https://api.mobula.io/api/1/market/trades/pair?sortOrder=desc&mode=pair&address=0xc4ce8e63921b8b6cbdb8fcb6bd64cc701fb926f2&blockchain=ethereum&transactionSenderAddress=0x33e833f33ced917af1c2879faa95f375a2a66407

​
Query Response

Each trade record includes:
  • Blockchain & transaction hash
  • Pair address and timestamp
  • Token prices (quoted token and USD)
  • Amounts in raw units, token units, and USD equivalent
  • Trade type & operation (e.g., buy, sell, swap)
  • Sender & transaction initiator addresses
  • Platform: Trading platform/aggregator identifier (e.g., “axiom”, “gmgn”, “padre”, “trojan”, “universalX”) or null if not available

Query Parameters

​
blockchain
string
​
asset
string
​
address
string
​
symbol
string
​
limit
number | null
​
amount
number | null
​
sortBy
string
​
sortOrder
enum<string>
default:desc
Available options:
asc,
desc
​
offset
number | null
default:0
​
mode
enum<string>
default:pair
Available options:
pair,
asset
​
transactionSenderAddress
string

Response

200 - application/json

Market trades response

​
data
object[]
required