Skip to main content
GET
/
2
/
token
/
trade
Get a single trade by transaction hash
curl --request GET \
  --url https://demo-api.mobula.io/api/2/token/trade
{
  "data": {
    "id": "<string>",
    "baseTokenAmount": 123,
    "baseTokenAmountRaw": "<string>",
    "baseTokenAmountUSD": 123,
    "quoteTokenAmount": 123,
    "quoteTokenAmountRaw": "<string>",
    "quoteTokenAmountUSD": 123,
    "date": 123,
    "swapSenderAddress": "<string>",
    "transactionSenderAddress": "<string>",
    "blockchain": "<string>",
    "transactionHash": "<string>",
    "marketAddress": "<string>",
    "baseTokenPriceUSD": 123,
    "quoteTokenPriceUSD": 123,
    "swapRecipient": "<string>",
    "marketAddresses": [
      "<string>"
    ],
    "baseTokenMarketCapUSD": 123,
    "quoteTokenMarketCapUSD": 123,
    "labels": [],
    "walletMetadata": {
      "entityName": "<string>",
      "entityLogo": "<string>",
      "entityLabels": [
        "<string>"
      ],
      "entityType": "<string>",
      "entityDescription": "<string>",
      "entityTwitter": "<string>",
      "entityWebsite": "<string>",
      "entityGithub": "<string>",
      "entityDiscord": "<string>",
      "entityTelegram": "<string>",
      "extra": {}
    },
    "baseToken": {
      "address": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "logo": "<string>",
      "decimals": 123
    },
    "quoteToken": {
      "address": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "logo": "<string>",
      "decimals": 123
    },
    "platform": {
      "id": "<string>",
      "name": "<string>",
      "logo": "<string>"
    },
    "totalFeesUSD": 123,
    "gasFeesUSD": 123,
    "platformFeesUSD": 123,
    "mevFeesUSD": 123
  }
}

​
Query Details

This endpoint retrieves a single trade by its transaction hash on a specific blockchain.
ParameterRequiredDescription
blockchainYesBlockchain identifier (e.g., “base”, “ethereum”, “bsc”)
transactionHashYesTransaction hash of the trade

​
Step-by-Step Tutorial and Video Walkthrough

  • Check out the guide: Here

​
Response Overview

The response contains a single trade object with the following fields:
  • id: Unique swap identifier
  • operation: Swap operation type (regular, deposit, withdrawal)
  • type: Trade type (buy, sell, deposit, or withdrawal)
  • baseTokenAmount: Amount of base token traded (formatted)
  • baseTokenAmountRaw: Amount of base token traded in smallest units
  • baseTokenAmountUSD: USD value of base token traded
  • quoteTokenAmount: Amount of quote token traded (formatted)
  • quoteTokenAmountRaw: Amount of quote token traded in smallest units
  • quoteTokenAmountUSD: USD value of quote token traded
  • date: Trade timestamp in milliseconds
  • swapSenderAddress: Address that executed the swap
  • transactionSenderAddress: Transaction originator address
  • swapRecipient: The actual beneficiary of the swap - the wallet that receives the output tokens. Critical for Account Abstraction (AA) scenarios. null if not available.
  • blockchain: Blockchain name
  • transactionHash: Transaction hash
  • marketAddress: Pool/market address where trade occurred
  • marketAddresses: Array of all market addresses involved (for multi-hop swaps)
  • preBalanceBaseToken: Pre-swap balance of base token (raw string, nullable)
  • preBalanceQuoteToken: Pre-swap balance of quote token (raw string, nullable)
  • postBalanceBaseToken: Post-swap balance of base token (raw string, nullable)
  • postBalanceQuoteToken: Post-swap balance of quote token (raw string, nullable)
  • baseTokenPriceUSD: Base token price in USD at execution
  • quoteTokenPriceUSD: Quote token price in USD at execution
  • labels: Array of wallet labels (e.g., smart-money, pro-trader)
  • walletMetadata: Enriched wallet metadata (entity name, logo, labels) from known wallets database. null if not available.
  • baseToken: Full token details for the base token (includes all fields from the Token Details schema)
  • quoteToken: Full token details for the quote token
  • platform: Trading platform/aggregator used for the trade. Object with id, name, logo fields. null if not available.
  • totalFeesUSD: Total fees paid in USD (sum of gas, platform, and MEV fees)
  • gasFeesUSD: Gas fees paid in USD
  • platformFeesUSD: Platform/aggregator fees paid in USD (e.g., Axiom, GMGN, Trojan)
  • mevFeesUSD: MEV/priority fees paid in USD
This endpoint is useful when you have a transaction hash and want to retrieve the trade details without knowing the pool or token address.
If the transaction contains multiple swaps, only the most recent one will be returned. The transaction must exist in the indexed blockchain data.

​
Usage Examples

Query a trade by transaction hash (GET): 
curl -X GET "https://api.mobula.io/api/2/token/trade?blockchain=base&transactionHash=0x123abc456def789..."
Query a trade by transaction hash (POST): 
curl -X POST "https://api.mobula.io/api/2/token/trade" \
  -H "Content-Type: application/json" \
  -d '{
    "blockchain": "base",
    "transactionHash": "0x123abc456def789..."
  }'
Query on Ethereum: 
curl -X GET "https://api.mobula.io/api/2/token/trade?blockchain=ethereum&transactionHash=0xabc123..."

​
Sample Response

{
  "data": {
    "id": "987654321",
    "operation": "regular",
    "type": "buy",
    "baseTokenAmount": 250.75,
    "baseTokenAmountRaw": "250750000000000000000",
    "baseTokenAmountUSD": 3000.9,
    "quoteTokenAmount": 3000.9,
    "quoteTokenAmountRaw": "3000900000",
    "quoteTokenAmountUSD": 3000.9,
    "date": 1699545600000,
    "swapSenderAddress": "0xabc123def456...",
    "transactionSenderAddress": "0xdef456abc789...",
    "swapRecipient": "0xabc123def456...",
    "blockchain": "Base",
    "transactionHash": "0x123abc456def789...",
    "marketAddress": "0x4200000000000000000000000000000000000006",
    "marketAddresses": ["0x4200000000000000000000000000000000000006"],
    "baseTokenPriceUSD": 11.96,
    "quoteTokenPriceUSD": 1.0,
    "labels": ["smart-money", "pro-trader"],
    "walletMetadata": null,
    "baseToken": { "...": "Full token details object" },
    "quoteToken": { "...": "Full token details object" },
    "platform": {
      "id": "axiom",
      "name": "Axiom",
      "logo": "https://..."
    },
    "totalFeesUSD": 3.25,
    "gasFeesUSD": 1.10,
    "platformFeesUSD": 1.50,
    "mevFeesUSD": 0.65
  }
}

​
Error Responses

404 - Trade not found: 
{
  "statusCode": 404,
  "message": "Trade not found"
}
404 - Pool not found: 
{
  "statusCode": 404,
  "message": "Pool not found"
}
400 - Missing parameters: 
{
  "statusCode": 400,
  "message": "Blockchain is required"
}

​
Use Cases

  • Transaction monitoring: Track specific trades after detecting a transaction on-chain
  • Trading analysis: Analyze individual trades with full context
  • User history: Show trade details when a user clicks on a transaction in their wallet
  • Price discovery: Get the exact execution price for a specific trade
  • Compliance: Retrieve detailed trade information for auditing purposes

Query Parameters

​
chainId
string

Blockchain chain ID (e.g., "evm:56", "solana:solana")

​
transactionHash
string
required

Transaction hash

Minimum string length: 1

Response

200 - application/json

Token trade response

​
data
object
required