Skip to main content
GET
/
2
/
token
/
trades
Get token trades
curl --request GET \
  --url https://demo-api.mobula.io/api/2/token/trades
{
  "data": [
    {
      "id": "<string>",
      "operation": "<string>",
      "type": "<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,
      "preBalanceBaseToken": "<string>",
      "preBalanceQuoteToken": "<string>",
      "postBalanceBaseToken": "<string>",
      "postBalanceQuoteToken": "<string>",
      "swapRecipient": "<string>",
      "marketAddresses": [
        "<string>"
      ],
      "labels": [],
      "walletMetadata": {
        "entityName": "<string>",
        "entityLogo": "<string>",
        "entityLabels": [
          "<string>"
        ],
        "entityType": "<string>",
        "entityDescription": "<string>",
        "entityTwitter": "<string>",
        "entityWebsite": "<string>",
        "entityGithub": "<string>",
        "entityDiscord": "<string>",
        "entityTelegram": "<string>"
      },
      "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 Parameters

blockchain
string

Blockchain name or chain ID

address
string

Token or pool contract address

offset
number | null

Offset for pagination (default: 0)

limit
number | null

Number of trades per page (default: 10)

sortOrder
enum<string>
required

Sort order: asc or desc (default: desc)

Available options:
asc,
desc
label
enum<string>

Filter by wallet label (e.g., sniper, insider, bundler)

Available options:
sniper,
insider,
bundler,
proTrader,
smartTrader,
freshTrader,
dev,
liquidityPool
swapTypes

Comma-separated swap types to filter (e.g., "REGULAR,MEV")

type
enum<string>

Filter by trade direction: "buy" or "sell"

Available options:
buy,
sell
transactionSenderAddresses

Comma-separated wallet addresses to filter (max 25)

maxAmountUSD
number | null

Maximum trade amount in USD

minAmountUSD
number | null

Minimum trade amount in USD

fromDate

Start date filter (timestamp or ISO string)

toDate

End date filter (timestamp or ISO string)

Response

200 - application/json

Token trades response

data
object[]
required