GET /token/analytics/token/{id}/traders
GET

/v1/token/analytics/token/{id}/traders

Top traders for token

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/token/analytics/token/0dd550278b74cb6690fdae351e8e0df3/traders
Path parameterValueDescription
idA token id: its md5, slug or issuer_currency
Query parameterValueDescription
offsetint
limitint (max 100, default 50)
sortvolume24h|volume7d|volume30d|volumeTotal|trades24h|tradesTotal|realizedPnl|unrealizedPnl|totalPnl|holding|lastTradeAt|firstTradeAt
addressfilter
curl 'https://api.xrpl.to/v1/token/analytics/token/0dd550278b74cb6690fdae351e8e0df3/traders'

Response

200Example response147 ms · just now · 7.5 KB · 225 lines
https://api.xrpl.to/v1/token/analytics/token/0dd550278b74cb6690fdae351e8e0df3/traders
{
  "traders": [
    {
      "_id": "6ad17d92f6db4d31142fb436",
      "address": "rpiFwLYi6Gb1ESHYorn2QG1WU5vw2u4exQ",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "actualBalance": 22992.5862126879,
      "ammTokensBought": 7463948.74775252,
      "ammTrades": 32339,
      "ammVolume": 9398955.201606002,
      "avgBuyPrice": 0.605326551286028,
      "avgSellPrice": 0.604338294874936,
      "balanceLastUpdated": "2026-11-01T06:56:36.294Z",
      "buyCount": 622969,
      "buyVolume": 204797798.50729808,
      "dexTokensBought": 64832465.1852419,
      "dexTrades": 1224967,
      "dexVolume": 400365938.2464235,
      "firstTradeDate": 1734541501000,
      "inferredReceived": 856382.4598151378,
      "lastTradeDate": 1793516192000,
      "profit24h": 48942.60467900005,
      "profit30d": 5297.560445999869,
      "profit7d": -1683.9818039999614,
      "sellCount": 634337,
      "sellRatio": 50.452077696280774,
      "sellVolume": 204967094.94073138,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 338326144.908399,
      "tokensSold": 339159534.782001,
      "totalTrades": 1257306,
      "tradePercentage": 6.272561632500584,
      "trades24h": 1312,
      "trades30d": 76334,
      "trades7d": 17347,
      "updatedAt": "2026-11-01T06:56:36.295Z",
      "volume24h": 313452.29119699984,
      "volume30d": 24231591.989253994,
      "volume7d": 5043611.249023999,
      "washSelfTrades": 0
    },
    {
      "_id": "6ad180cef6db4d311430f809",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "address": "r3nVVxJfkdvjiXP1tov5pZdht96JMwGApP",
      "actualBalance": 79.49281537092455,
      "ammTokensBought": 709262.198879787,
      "ammTrades": 5216,
      "ammVolume": 942842.1909319998,
      "avgBuyPrice": 0.747454061749685,
      "avgSellPrice": 0.747731856528328,
      "balanceLastUpdated": "2026-11-01T06:37:41.418Z",
      "buyCount": 35299,
      "buyVolume": 7582126.476214056,
      "dexTokensBought": 9434674.21704617,
      "dexTrades": 65310,
      "dexVolume": 14224169.254757049,
      "firstTradeDate": 1789654922000,
      "inferredReceived": 1.70685126e-7,
      "lastTradeDate": 1793515060000,
      "profit24h": -114.11755100000119,
      "profit30d": 2499.309431000019,
      "profit7d": 5639.333887000046,
      "sellCount": 35227,
      "sellRatio": 49.948954995320875,
      "sellVolume": 7584884.969474994,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 10143936.4159255,
      "tokensSold": 10143856.9231103,
      "totalTrades": 70526,
      "tradePercentage": 0.351849527378369,
      "trades24h": 1326,
      "trades30d": 55154,
      "trades7d": 17462,
      "updatedAt": "2026-11-01T06:37:41.418Z",
      "volume24h": 228612.49045299995,
      "volume30d": 13873287.688254997,
      "volume7d": 4636841.690982998,
      "washSelfTrades": 0
    },
    {
      "_id": "6ad1801cf6db4d311430d27a",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "address": "r3cpW3M3nKHfSgkJiEh1BaAy6GJXeZvMLU",
      "actualBalance": 21498.19348728689,
      "ammTokensBought": 2344864.83179554,
      "ammTrades": 12562,
      "ammVolume": 3352833.486558995,
      "avgBuyPrice": 0.785000007793514,
      "avgSellPrice": 0.785458403921201,
      "balanceLastUpdated": "2026-11-01T06:50:24.405Z",
      "buyCount": 119425,
      "buyVolume": 33916108.40970101,
      "dexTokensBought": 40860367.3210196,
      "dexTrades": 205792,
      "dexVolume": 64482302.50770112,
      "firstTradeDate": 1776353782000,
      "inferredReceived": 8.86942871e-7,
      "lastTradeDate": 1793515821000,
      "profit24h": -6979.561341999997,
      "profit30d": -14408.337459999984,
      "profit7d": -17204.503468000014,
      "sellCount": 98929,
      "sellRatio": 45.30670379292342,
      "sellVolume": 33919027.584559105,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 43205233.2139878,
      "tokensSold": 43183735.0205014,
      "totalTrades": 218354,
      "tradePercentage": 1.089347617702515,
      "trades24h": 460,
      "trades30d": 26589,
      "trades7d": 5358,
      "updatedAt": "2026-11-01T06:50:24.405Z",
      "volume24h": 165878.478914,
      "volume30d": 11135504.052434003,
      "volume7d": 2414811.1501800003,
      "washSelfTrades": 0
    },
    {
      "_id": "6ad18060f6db4d311430e36b",
      "address": "rKYdJJLAgxbJcn9Ria2X5jMMiqP91r4qy",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "actualBalance": 2938.698325462184,
      "ammTokensBought": 1480111.63330113,
      "ammTrades": 13229,
      "ammVolume": 2086762.1745229966,
      "avgBuyPrice": 0.745074497215812,
      "avgSellPrice": 0.74534187960481,
      "balanceLastUpdated": "2026-11-01T07:00:20.229Z",
      "buyCount": 125611,
      "buyVolume": 19855711.340181094,
      "dexTokensBought": 25169185.0670653,
      "dexTrades": 222807,
      "dexVolume": 37629595.72352192,
      "firstTradeDate": 1782147122000,
      "inferredReceived": 0,
      "lastTradeDate": 1793516420000,
      "profit24h": 3298.1711919999952,
      "profit30d": -702.0238679999748,
      "profit7d": 5892.213659000008,
      "sellCount": 110425,
      "sellRatio": 46.783117829483636,
      "sellVolume": 19860646.55786382,
      "sourceTagStats": [],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 26649296.7003672,
      "tokensSold": 26646358.0020409,
      "totalTrades": 236036,
      "tradePercentage": 1.177556756812848,
      "trades24h": 775,
      "trades30d": 44045,
      "trades7d": 8811,
      "updatedAt": "2026-11-01T07:00:20.229Z",
      "volume24h": 152526.6964599999,
      "volume30d": 11131903.569748001,
      "volume7d": 2363807.398655,
      "washSelfTrades": 0
    },
    {
      "_id": "6ad180c1f6db4d311430f377",
      "address": "rKfa1JLEDBg3MJcs1Tozi3unKfU3PeZq5y",
      "tokenId": "0dd550278b74cb6690fdae351e8e0df3",
      "actualBalance": 18013.12006083135,
      "ammTokensBought": 32152.3667892021,
      "ammTrades": 150,
      "ammVolume": 52875.684671999996,
      "avgBuyPrice": 0.695312209899097,
      "avgSellPrice": 0.694895507875461,
      "balanceLastUpdated": "2026-11-01T06:25:51.628Z",
      "buyCount": 7775,
      "buyVolume": 7253649.144511998,
      "dexTokensBought": 101904.967859941,
      "dexTrades": 16311,
      "dexVolume": 14437558.241431989,
      "firstTradeDate": 1788313502000,
      "inferredReceived": 0,
      "lastTradeDate": 1793514350000,
      "profit24h": 10.508690999997725,
      "profit30d": 252.69066099998577,
      "profit7d": 1.809334999999702,
      "sellCount": 8686,
      "sellRatio": 52.76714658890711,
      "sellVolume": 7236784.781591991,
      "sourceTagStats": [
        {
          "sourceTag": 10011010,
          "trades": 12,
          "volume": 232.56094099999999,
          "profit": 232.56094099999999
        }
      ],
      "suspiciousActivity": true,
      "tokenDeposited": 0,
      "tokenWithdrawn": 0,
      "tokensBought": 10432218.852542,
      "tokensSold": 10414205.7324811,
      "totalTrades": 16461,
      "tradePercentage": 0.082123138310212,
      "trades24h": 160,
      "trades30d": 2937,
      "trades7d": 197,
      "updatedAt": "2026-11-01T06:25:51.628Z",
      "volume24h": 133945.330457,
      "volume30d": 1828390.9539450004,
      "volume7d": 180049.530811,
      "washSelfTrades": 0
    }
  ],
  "total": 46920,
  "page": 1,
  "limit": 50,
  "totalPages": 939
}

Long arrays and strings are shortened in the example; Send request for the full answer.

What it does

Top traders for token

A token id can be its md5, slug or issuer_currency. How to build an md5 →
OpenAPI