Skip to main content
GET
/
1
/
wallet
/
trades
Get Wallet Trades
curl --request GET \
  --url https://demo-api.mobula.io/api/1/wallet/trades
{
  "data": [
    {
      "chain_id": "<string>",
      "swap_type": "<string>",
      "raw_amount0": "<string>",
      "raw_amount1": "<string>",
      "amount0": 123,
      "amount1": 123,
      "ratio": 123,
      "price_usd_token0": 123,
      "price_usd_token1": 123,
      "date": "<string>",
      "amount_usd": 123,
      "pool_address": "<string>",
      "token0_address": "<string>",
      "token1_address": "<string>",
      "transaction_sender_address": "<string>",
      "transaction_hash": "<string>",
      "base": "<string>",
      "quote": "<string>",
      "side": "<string>",
      "amount_quote": 123,
      "amount_base": 123,
      "amount_quote_raw": "<string>",
      "amount_base_raw": "<string>",
      "labels": [
        "<string>"
      ],
      "raw_post_balance0": "<string>",
      "raw_post_balance1": "<string>",
      "raw_pre_balance0": "<string>",
      "raw_pre_balance1": "<string>",
      "base_token": {
        "address": "<string>",
        "chainId": "<unknown>",
        "symbol": "<string>",
        "name": "<string>",
        "priceTokenString": "<string>",
        "approximateReserveTokenRaw": "<string>",
        "logo": "<string>",
        "bondedAt": "<string>",
        "createdAt": "<string>",
        "latestTradeDate": "<string>",
        "description": "<string>",
        "socials": {
          "twitter": "<string>",
          "website": "<string>",
          "telegram": "<string>",
          "others": {},
          "uri": "<string>"
        },
        "security": {
          "buyTax": "<string>",
          "sellTax": "<string>",
          "transferPausable": true,
          "top10Holders": "<string>",
          "isBlacklisted": true,
          "noMintAuthority": true,
          "balanceMutable": true,
          "lowLiquidity": "<string>"
        },
        "decimals": 0,
        "id": null,
        "priceUSD": 0,
        "priceToken": 0,
        "approximateReserveUSD": 0,
        "approximateReserveToken": 0,
        "totalSupply": 0,
        "circulatingSupply": 0,
        "marketCapUSD": 0,
        "marketCapDilutedUSD": 0,
        "exchange": {
          "name": "<string>",
          "logo": "<string>"
        },
        "factory": "<string>",
        "source": "<string>",
        "sourceFactory": "<string>",
        "liquidityUSD": 123,
        "liquidityMaxUSD": 123,
        "bonded": true,
        "bondingPercentage": 123,
        "bondingCurveAddress": "<string>",
        "preBondingFactory": "<string>",
        "poolAddress": "<string>",
        "blockchain": "<string>",
        "type": "<string>",
        "deployer": "<string>",
        "athUSD": 123,
        "atlUSD": 123,
        "athDate": "<string>",
        "atlDate": "<string>",
        "priceChange1minPercentage": 0,
        "priceChange5minPercentage": 0,
        "priceChange1hPercentage": 0,
        "priceChange4hPercentage": 0,
        "priceChange6hPercentage": 0,
        "priceChange12hPercentage": 0,
        "priceChange24hPercentage": 0,
        "volume1minUSD": 0,
        "volume5minUSD": 0,
        "volume15minUSD": 0,
        "volume1hUSD": 0,
        "volume4hUSD": 0,
        "volume6hUSD": 0,
        "volume12hUSD": 0,
        "volume24hUSD": 0,
        "volumeBuy1minUSD": 0,
        "volumeBuy5minUSD": 0,
        "volumeBuy15minUSD": 0,
        "volumeBuy1hUSD": 0,
        "volumeBuy4hUSD": 0,
        "volumeBuy6hUSD": 0,
        "volumeBuy12hUSD": 0,
        "volumeBuy24hUSD": 0,
        "volumeSell1minUSD": 0,
        "volumeSell5minUSD": 0,
        "volumeSell15minUSD": 0,
        "volumeSell1hUSD": 0,
        "volumeSell4hUSD": 0,
        "volumeSell6hUSD": 0,
        "volumeSell12hUSD": 0,
        "volumeSell24hUSD": 0,
        "trades1min": 0,
        "trades5min": 0,
        "trades15min": 0,
        "trades1h": 0,
        "trades4h": 0,
        "trades6h": 0,
        "trades12h": 0,
        "trades24h": 0,
        "buys1min": 0,
        "buys5min": 0,
        "buys15min": 0,
        "buys1h": 0,
        "buys4h": 0,
        "buys6h": 0,
        "buys12h": 0,
        "buys24h": 0,
        "sells1min": 0,
        "sells5min": 0,
        "sells15min": 0,
        "sells1h": 0,
        "sells4h": 0,
        "sells6h": 0,
        "sells12h": 0,
        "sells24h": 0,
        "buyers1min": 0,
        "buyers5min": 0,
        "buyers15min": 0,
        "buyers1h": 0,
        "buyers4h": 0,
        "buyers6h": 0,
        "buyers12h": 0,
        "buyers24h": 0,
        "sellers1min": 0,
        "sellers5min": 0,
        "sellers15min": 0,
        "sellers1h": 0,
        "sellers4h": 0,
        "sellers6h": 0,
        "sellers12h": 0,
        "sellers24h": 0,
        "traders1min": 0,
        "traders5min": 0,
        "traders15min": 0,
        "traders1h": 0,
        "traders4h": 0,
        "traders6h": 0,
        "traders12h": 0,
        "traders24h": 0,
        "feesPaid1minUSD": 0,
        "feesPaid5minUSD": 0,
        "feesPaid15minUSD": 0,
        "feesPaid1hUSD": 0,
        "feesPaid4hUSD": 0,
        "feesPaid6hUSD": 0,
        "feesPaid12hUSD": 0,
        "feesPaid24hUSD": 0,
        "totalFeesPaidUSD": 0,
        "organicTrades1min": 0,
        "organicTrades5min": 0,
        "organicTrades15min": 0,
        "organicTrades1h": 0,
        "organicTrades4h": 0,
        "organicTrades6h": 0,
        "organicTrades12h": 0,
        "organicTrades24h": 0,
        "organicTraders1min": 0,
        "organicTraders5min": 0,
        "organicTraders15min": 0,
        "organicTraders1h": 0,
        "organicTraders4h": 0,
        "organicTraders6h": 0,
        "organicTraders12h": 0,
        "organicTraders24h": 0,
        "organicVolume1minUSD": 0,
        "organicVolume5minUSD": 0,
        "organicVolume15minUSD": 0,
        "organicVolume1hUSD": 0,
        "organicVolume4hUSD": 0,
        "organicVolume6hUSD": 0,
        "organicVolume12hUSD": 0,
        "organicVolume24hUSD": 0,
        "organicVolumeBuy1minUSD": 0,
        "organicVolumeBuy5minUSD": 0,
        "organicVolumeBuy15minUSD": 0,
        "organicVolumeBuy1hUSD": 0,
        "organicVolumeBuy4hUSD": 0,
        "organicVolumeBuy6hUSD": 0,
        "organicVolumeBuy12hUSD": 0,
        "organicVolumeBuy24hUSD": 0,
        "organicVolumeSell1minUSD": 0,
        "organicVolumeSell5minUSD": 0,
        "organicVolumeSell15minUSD": 0,
        "organicVolumeSell1hUSD": 0,
        "organicVolumeSell4hUSD": 0,
        "organicVolumeSell6hUSD": 0,
        "organicVolumeSell12hUSD": 0,
        "organicVolumeSell24hUSD": 0,
        "organicBuys1min": 0,
        "organicBuys5min": 0,
        "organicBuys15min": 0,
        "organicBuys1h": 0,
        "organicBuys4h": 0,
        "organicBuys6h": 0,
        "organicBuys12h": 0,
        "organicBuys24h": 0,
        "organicSells1min": 0,
        "organicSells5min": 0,
        "organicSells15min": 0,
        "organicSells1h": 0,
        "organicSells4h": 0,
        "organicSells6h": 0,
        "organicSells12h": 0,
        "organicSells24h": 0,
        "organicBuyers1min": 0,
        "organicBuyers5min": 0,
        "organicBuyers15min": 0,
        "organicBuyers1h": 0,
        "organicBuyers4h": 0,
        "organicBuyers6h": 0,
        "organicBuyers12h": 0,
        "organicBuyers24h": 0,
        "organicSellers1min": 0,
        "organicSellers5min": 0,
        "organicSellers15min": 0,
        "organicSellers1h": 0,
        "organicSellers4h": 0,
        "organicSellers6h": 0,
        "organicSellers12h": 0,
        "organicSellers24h": 0,
        "holdersCount": 123,
        "twitterReusesCount": 0,
        "twitterRenameCount": 0,
        "twitterRenameHistory": [],
        "deployerMigrationsCount": 0,
        "dexscreenerListed": false,
        "dexscreenerHeader": null,
        "dexscreenerAdPaid": false,
        "top10HoldingsPercentage": 123,
        "top50HoldingsPercentage": 123,
        "top100HoldingsPercentage": 123,
        "top200HoldingsPercentage": 123,
        "devHoldingsPercentage": 123,
        "insidersHoldingsPercentage": 123,
        "bundlersHoldingsPercentage": 123,
        "snipersHoldingsPercentage": 123,
        "proTradersHoldingsPercentage": 123,
        "freshTradersHoldingsPercentage": 123,
        "smartTradersHoldingsPercentage": 123,
        "insidersCount": 123,
        "bundlersCount": 123,
        "snipersCount": 123,
        "freshTradersCount": 123,
        "proTradersCount": 123,
        "smartTradersCount": 123,
        "freshTradersBuys": 123,
        "proTradersBuys": 123,
        "smartTradersBuys": 123
      }
    }
  ]
}

​
Query Details

  • You must provide either the wallet parameter or the wallets parameter.
ParameterRequiredDescription
walletCond.Single wallet address to query trades for.
walletsCond.Comma-separated list of wallet addresses to query trades for.
fromCond.Start timestamp for trade filtering (Unix ms or ISO 8601).
toCond.End timestamp for trade filtering (Unix ms or ISO 8601).
limitCond.Number of results per page (default varies).
offsetCond.Offset for pagination.
pageCond.Page number for pagination.
orderCond.Sort order: asc or desc (default desc).

​
Response Overview

Each item in data[] represents a single swap involving the queried wallet:
  • pool_address: AMM pool contract address where the swap happened
  • token0_address / token1_address: The two pool token contract addresses
  • base: Contract address of the base asset in the pool orientation (determined by baseQuote)
  • quote: Contract address of the quote asset in the pool orientation
  • amount_base: Absolute (positive) amount of base token in the trade (formatted with decimals)
  • amount_quote: Absolute (positive) amount of quote token in the trade (formatted with decimals)
  • amount_base_raw: Absolute raw amount of base token in smallest units
  • amount_quote_raw: Absolute raw amount of quote token in smallest units
  • side: Either buy (wallet bought the base token) or sell (wallet sold the base token)
  • transaction_hash: Transaction hash of the swap
  • transaction_sender_address: Originating wallet address (the queried wallet)
  • date: ISO date of the swap
  • amount_usd: Trade notional in USD (best-effort; can be 0 for illiquid tokens)
  • raw_amount0 / raw_amount1: Raw pool token deltas in smallest units (can be negative or positive)
  • amount0 / amount1: Formatted pool token deltas (can be negative or positive)
  • price_usd_token0 / price_usd_token1: USD prices at execution time (best-effort)
  • ratio: Trade price ratio
  • base_token: Enriched details for the base token determined by baseQuote (includes id, name, symbol, decimals, price, volume, market cap, liquidity, and many other stats)
  • labels: Wallet labels if available
  • platform: Trading platform/aggregator identifier (e.g., “axiom”, “gmgn”, “padre”, “trojan”, “universalX”) or null if not available
All amounts (amount_base, amount_quote, amount_base_raw, amount_quote_raw) are now returned as absolute (positive) values for easier consumption. The side field indicates the direction of the trade relative to the base token.
The base_token field always contains enriched data for the base token as determined by baseQuote logic, regardless of the trade direction (buy or sell).

​
Usage Examples

  • Query trades for a single wallet with limit and order:
curl -X GET "https://demo-api.mobula.io/api/1/wallet/trades?wallet=0x1234abcd5678efgh&limit=10&order=desc"
  • Query Trades for Multiple Wallets with Limit and Descending Order
curl -X GET "demo-api.mobula.io/api/1/wallet/trades?wallets=0xaF88370abD82EC6943cdB3D4ec7b764B92c35B43&limit=10&order=desc"

​
Sample Response Item

{
  "chain_id": "evm:8453",
  "swap_type": "REGULAR",
  "raw_amount0": "-1200000000",
  "raw_amount1": "3500000000000000000000",
  "amount0": -1200,
  "amount1": 3500,
  "ratio": 2.9166666667,
  "price_usd_token0": 1.0,
  "price_usd_token1": 0.000342,
  "date": "2025-08-01T12:34:56.000Z",
  "amount_usd": 1200.0,
  "pool_address": "0xPool...",
  "token0_address": "0xToken0...",
  "token1_address": "0xToken1...",
  "transaction_sender_address": "0xWallet...",
  "transaction_hash": "0xTx...",
  "base": "0xToken1...",
  "quote": "0xToken0...",
  "side": "buy",
  "amount_quote": 1200,
  "amount_base": 3500,
  "amount_quote_raw": "1200000000",
  "amount_base_raw": "3500000000000000000000",
  "base_token": {
    "symbol": "TOKEN",
    "name": "Token Name",
    "decimals": 18,
    "address": "0xToken1...",
    "chainId": "evm:8453",
    "priceUSD": 0.000342,
    "liquidityUSD": 500000,
    "volume24hUSD": 150000,
    "marketCapUSD": 1000000,
    "priceChange24hPercentage": 5.2
  },
  "labels": ["smart-money"],
  "platform": "axiom"
}

Query Parameters

​
limit
string
default:100
​
offset
string
default:0
​
page
string
default:1
​
order
string
​
wallet
string
​
wallets
string
​
from
string
​
to
string

Response

200 - application/json

Wallet Trades response

​
data
object[]
required