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

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

The response is of type object.