Query: metrics

Retrieve historical on-chain metrics for one or more tokens, filtered by date, address, chain, and optionally sorted and paginated.

Example Query

query Metrics(
  $partitionDate: [String!]!,
  $address: [String],
  $chains: [String],
  $limit: Int,
  $offset: Int,
  $sortBy: String,
  $sortOrder: String
) {
  metrics(
    partition_date: $partitionDate,
    address: $address,
    chains: $chains,
    limit: $limit,
    offset: $offset,
    sortBy: $sortBy,
    sortOrder: $sortOrder
  ) {
    current_count
    total_count
    metrics {
      asset_id
      partition_date
      typical_price
      wallet_count
      risk_score
      token {
        symbol
        address
        chain
      }
    }
  }
}

---

Arguments

Argument	Type	Description
partitionDate	[String!]	Required. List of dates (YYYY-MM-DD) to fetch metrics for
address	[String]	Optional. One or more token contract addresses
chains	[String]	Optional. Filter by blockchain (e.g., ETHEREUM, POLYGON)
limit	Int	(Default: 10) Max number of results per page
offset	Int	(Default: 0) Offset for pagination
sortBy	String	Column to sort by (e.g., wallet_count, partition_date)
sortOrder	String	Sort direction: ASC or DESC

---

Returns

Returns a MetricPagination object:

MetricPagination

Field	Type	Description
metrics	[Metric]	List of metric records matching the filter
total_count	Int	Total number of available records (before paging)
current_count	Int	Number of metrics returned in the current response

Metric Object

Field	Type	Description
asset_id	ID	Internal token identifier
partition_date	String	Snapshot date (YYYY-MM-DD)
typical_price	Float	Average token price
wallet_count	Int	Active wallet count for the token
wallet_count_change_1D	Int	Change in wallet count over 1 day
wallet_count_change_7D	Int	... over 7 days
wallet_count_change_30D	Int	... over 30 days
wallet_count_change_90D	Int	... over 90 days
wallet_count_change_365D	Int	... over 365 days
pct_price_change_1D	Float	% change in price over 1 day
price_change_7D	Float	Price delta over 7 days
price_change_30D	Float	... over 30 days
price_change_90D	Float	... over 90 days
price_change_180D	Float	... over 180 days
price_change_365D	Float	... over 365 days
life_cycle_v1	Float	Lifecycle score
diversity	Float	Wallet distribution metric
dominance	Float	Top holder dominance score
assortativity	Float	Network assortativity metric
risk_score	Float	Xerberus risk score
risk_rating	String	Letter-based risk rating (e.g., AAA, C, etc.)
token	Token	Associated token object