GET /whale-activity/{id}
GET

/v1/whale-activity/{id}

Whale social-proof trade events — top holders of major tokens, smart money, named accounts, whale-sized and fresh-wallet trades on this token

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/whale-activity/0dd550278b74cb6690fdae351e8e0df3
Path parameterValueDescription
idmd5 or trader r-address
Query parameterValueDescription
idmd5 or trader r-address
sinceunix ms — return events strictly newer (exclusive)
limitint (max 200)
curl 'https://api.xrpl.to/v1/whale-activity/0dd550278b74cb6690fdae351e8e0df3'

Response

200Example response1 ms · just now · 2.9 KB · 106 lines
https://api.xrpl.to/v1/whale-activity/0dd550278b74cb6690fdae351e8e0df3
{
  "success": true,
  "took": 1,
  "count": 50,
  "events": [
    {
      "_id": "F5D69FC08B6E159017D6A4141167EEA0B2B1B33E1C8B28BAF75CE97F5A036F24_SX6e3as8",
      "token": "0dd550278b74cb6690fdae351e8e0df3",
      "account": "rPmpJg1oJqctB4DkRXMAutycGBSX6e3as8",
      "side": "buy",
      "xrpAmount": 21000,
      "tokenAmount": 29786.288919,
      "time": 1789952760000,
      "ledger": 107125965,
      "hash": "F5D69FC08B6E159017D6A4141167EEA0B2B1B33E1C8B28BAF75CE97F5A036F24",
      "badges": [
        {
          "t": "size",
          "pct": 0,
          "tvlPct": 1
        },
        {
          "t": "smart",
          "pnl": 42425,
          "wr": 96
        },
        {
          "t": "named",
          "name": "ChangeNOW"
        }
      ]
    },
    {
      "_id": "D2E7DABA21AD8E842BCB5D97D8A568D4413F5952670CE76CD2846AE56A4753A3_bjTMXa9Q",
      "token": "0dd550278b74cb6690fdae351e8e0df3",
      "account": "rh6L42v4hRscNh7e98cyr6GoeDbjTMXa9Q",
      "side": "buy",
      "xrpAmount": 20000,
      "tokenAmount": 28490.922814,
      "time": 1789952062000,
      "ledger": 107125784,
      "hash": "D2E7DABA21AD8E842BCB5D97D8A568D4413F5952670CE76CD2846AE56A4753A3",
      "badges": [
        {
          "t": "size",
          "pct": 0,
          "tvlPct": 1
        }
      ]
    },
    {
      "_id": "9922F12BB20F23873BEA2837FAF28933760D33D6322DBF08AA0CE9454C8FD22E_C9npACTZ",
      "token": "0dd550278b74cb6690fdae351e8e0df3",
      "account": "rLE4j8hmwuqvqSMjoNV1ai3EtZC9npACTZ",
      "side": "sell",
      "xrpAmount": 11352.869726,
      "tokenAmount": 16132.200821,
      "time": 1789951382000,
      "ledger": 107125608,
      "hash": "9922F12BB20F23873BEA2837FAF28933760D33D6322DBF08AA0CE9454C8FD22E",
      "badges": [
        {
          "t": "size",
          "pct": 0,
          "tvlPct": 0
        }
      ]
    },
    {
      "_id": "997D84EED652FF8E97C9EE9ACBBE8C626CCD86C1D855801C03466B08D4A6C2D1_dZEBShdh",
      "token": "0dd550278b74cb6690fdae351e8e0df3",
      "account": "r98NQ8BQRHWZhFnGp67xAaPBnYdZEBShdh",
      "side": "sell",
      "xrpAmount": 30317.557489,
      "tokenAmount": 43244.964003,
      "time": 1789951021000,
      "ledger": 107125514,
      "hash": "997D84EED652FF8E97C9EE9ACBBE8C626CCD86C1D855801C03466B08D4A6C2D1",
      "badges": [
        {
          "t": "size",
          "pct": 1,
          "tvlPct": 1
        }
      ]
    },
    {
      "_id": "1FDF70D34A5B312FB6C80AB160EDF5D3414351D5BC8682359241AF59A56B9243_k2tnvwm3",
      "token": "0dd550278b74cb6690fdae351e8e0df3",
      "account": "rtetfYmvPjL6Z1jUznfPaJXHok2tnvwm3",
      "side": "sell",
      "xrpAmount": 14939.14,
      "tokenAmount": 21362.9702,
      "time": 1789950181000,
      "ledger": 107125296,
      "hash": "1FDF70D34A5B312FB6C80AB160EDF5D3414351D5BC8682359241AF59A56B9243",
      "badges": [
        {
          "t": "size",
          "pct": 0,
          "tvlPct": 0
        }
      ]
    }
  ]
}

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

What it does

Whale social-proof trade events — top holders of major tokens, smart money, named accounts, whale-sized and fresh-wallet trades on this token

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