📖
Xerberus
xerberus.io
  • APIs
    • Getting Started
    • Risk Ratings API
      • Index Ratings
      • Cardano
      • Ethereum
      • Polygon
      • API Response Signature Headers
  • AI Agent API
    • Introduction
    • Tokens
      • Query: tokens
      • Query: tokensBySimilarSymbol
      • Query: tokensBySimilarAddress
    • Metrics
      • Query: metrics
    • Chains
  • SIREN API
Powered by GitBook
On this page
  1. AI Agent API
  2. Metrics

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

PreviousMetricsNextChains

Last updated 1 month ago