onDetailedTokenStatsUpdated

This endpoint requires a Growth or Enterprise plan. Learn more.

Returns

DetailedTokenStats

See DetailedTokenStats

Show Properties

String!

The ID of the token (tokenAddress:networkId).

String!

The contract address of the token.

Int!

The network ID the token is deployed on.

Int

The unix timestamp for the last event to happen on the token.

TokenPairStatisticsType!

The type of statistics returned. Can be FILTERED or UNFILTERED. See TokenPairStatisticsType

WindowedDetailedTokenStats

The breakdown of stats over a 5 minute window. See WindowedDetailedTokenStats

WindowedDetailedTokenStats

The breakdown of stats over an hour window. See WindowedDetailedTokenStats

WindowedDetailedTokenStats

The breakdown of stats over a 4 hour window. See WindowedDetailedTokenStats

WindowedDetailedTokenStats

The breakdown of stats over a 12 hour window. See WindowedDetailedTokenStats

WindowedDetailedTokenStats

The breakdown of stats over a 24 hour window. See WindowedDetailedTokenStats

Int

Number of aggregated buckets specified in input

Int

The timestamp specified as input to the query

Arguments

String

The ID of the token (address:networkId). Required unless you are on an enterprise plan including TokenStatsFeed features.

Int

The network ID to stream stats for every token on. Used only when tokenId is omitted.

This is the live-streamed subscription version of our getDetailedTokenStats query. Subscribe to receive aggregated token statistics across specified time periods.

Example

Test this query in the Explorer →

subscription {
  onDetailedTokenStatsUpdated(
    tokenId: "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump:1399811149"
  ) {
    networkId
    statsType
    lastTransactionAt
    stats_hour1 {
      duration
      start
      end
      statsUsd {
        volume { currentValue previousValue change }
        buyVolume { currentValue previousValue change }
        sellVolume { currentValue previousValue change }
        close { currentValue previousValue change }
        liquidity { currentValue previousValue change }
      }
      statsNonCurrency {
        transactions { currentValue previousValue change }
        buyers { currentValue previousValue change }
        sellers { currentValue previousValue change }
      }
    }
    stats_day1 {
      duration
      start
      end
      statsUsd {
        volume { currentValue previousValue change }
      }
      statsNonCurrency {
        transactions { currentValue previousValue change }
        traders { currentValue previousValue change }
      }
    }
  }
}

Example Response

{
  "data": {
    "onDetailedTokenStatsUpdated": {
      "networkId": 1399811149,
      "statsType": "UNFILTERED",
      "lastTransactionAt": 1776984285,
      "stats_hour1": {
        "duration": "hour1",
        "start": 1776980685,
        "end": 1776984286,
        "statsUsd": {
          "volume": {
            "currentValue": "265748.10827470712163",
            "previousValue": "244878.07126917266842",
            "change": 0.08522623890888899
          },
          "buyVolume": {
            "currentValue": "144528.01349863471001",
            "previousValue": "189502.71839593273572",
            "change": -0.23733013055428184
          },
          "sellVolume": {
            "currentValue": "121220.09477711560805",
            "previousValue": "55375.35287204386872",
            "change": 1.1890622540540652
          },
          "close": {
            "currentValue": "0.201000590004",
            "previousValue": "0.200065560622",
            "change": 0.004673614884505917
          },
          "liquidity": {
            "currentValue": "5922753.22554",
            "previousValue": "5915693.52645",
            "change": 0.0011933848598537045
          }
        },
        "statsNonCurrency": {
          "transactions": { "currentValue": 2678, "previousValue": 2514, "change": 0.06523468575974542 },
          "buyers": { "currentValue": 216, "previousValue": 216, "change": 0 },
          "sellers": { "currentValue": 207, "previousValue": 195, "change": 0.06153846153846154 }
        }
      },
      "stats_day1": {
        "duration": "day1",
        "start": 1776897885,
        "end": 1776984286,
        "statsUsd": {
          "volume": {
            "currentValue": "4392297.38289152088393",
            "previousValue": "6096041.545027661300558",
            "change": -0.2794836861841645
          }
        },
        "statsNonCurrency": {
          "transactions": { "currentValue": 50259, "previousValue": 53152, "change": -0.05442880794701987 },
          "traders": { "currentValue": 3658, "previousValue": 3550, "change": 0.030422535211267605 }
        }
      }
    }
  }
}

Usage Guidelines

Subscribe using tokenId in the format tokenAddress:networkId to stream detailed stats for a specific token.
Use this subscription to keep token pages, dashboards, or watchlists live without repeatedly polling getDetailedTokenStats.
Stats cover the same windows supported by getDetailedTokenStats (5m, 1h, 4h, 12h, 24h). Request only the timeframes and fields you need.
Supports both non-currency stats (buyers, buys, sellers, sells, traders, transactions) and USD stats (buy/sell volume, open/close, highest/lowest, liquidity).

Troubleshooting Tips

How does this differ from onDetailedStatsUpdated?

onDetailedStatsUpdated streams updates for specific pairs only. onDetailedTokenStatsUpdated streams aggregated stats across all pairs for a specified token.

What does statsType: FILTERED vs UNFILTERED mean?

FILTERED excludes suspected bot and sandwich attack transactions for cleaner stats. UNFILTERED includes all transactions.

Detailed Token Page: Build a comprehensive token detail page with price, holders, trades, and real-time updates

API Documentation

Queries

Mutations

Subscriptions

Types

onDetailedTokenStatsUpdated

Returns

Arguments

Example

Usage Guidelines

Troubleshooting Tips

​Returns

​Arguments

​Example

​Usage Guidelines

​Troubleshooting Tips

​Related Recipes

Returns

Arguments

Example

Usage Guidelines

Troubleshooting Tips

Related Recipes