Skip to main content
The RWA API provides timeseries endpoints for tracking metrics over time and aggregating data across assets, tokens, networks, and asset classes.

​
Timeseries endpoints

EndpointGranularityUse case
/v4/assets/aggregates/timeseriesAsset-levelTrack NAV, supply, or holders for one or many assets
/v4/tokens/aggregates/timeseriesToken-levelBreak down metrics by chain (e.g., supply per network)
Both endpoints use the same query language and response format.

​
The aggregate block

Timeseries queries use an aggregate block to control grouping, time resolution, and computation mode: 
{
  "aggregate": {
    "groupBy": "asset",
    "aggregateFunction": "sum",
    "interval": "day",
    "mode": "stock"
  }
}

​
groupBy

Controls how results are grouped. Each unique group becomes a separate series in the response.
ValueDescriptionReturns
assetGroup by assetOne series per asset
tokenGroup by tokenOne series per on-chain token (chain-level granularity)
asset_classGroup by asset classOne series per asset class
networkGroup by networkOne series per blockchain network
dateNo entity groupingA single combined series

​
interval

The time resolution of each data point.
ValueDescription
dayOne point per day
weekOne point per week
monthOne point per month
yearOne point per year

​
mode

How values are computed within each interval.
ValueDescriptionUse when
stockPoint-in-time snapshot (latest value in the period)Tracking balances, NAV, supply, holders — metrics that represent a state
flowAccumulated over the periodTracking mints, burns, transfers — metrics that represent activity
Example: For monthly supply, stock returns the supply at the end of each month. For monthly mints, flow returns the total minted during each month.

​
aggregateFunction

ValueDescription
sumSum values across the group
avgAverage across the group
minMinimum value in the group
maxMaximum value in the group

​
Discovering available measures

Every timeseries query requires a measure_slug filter to specify which metric to retrieve. Use the meta endpoints to discover available measures: 
curl -X GET 'https://api.rwa.xyz/v4/assets/aggregates/meta' \
  -H "Authorization: Bearer $RWA_API_KEY"
The measure_slug field in the response lists all available measures as selectOptions. You can also browse measures in the Data Catalog. Common measures:
SlugDescription
net_asset_value_dollarNAV in USD
price_dollarPrice in USD
circulating_supply_tokenCirculating token supply
circulating_market_value_dollarCirculating market value in USD
circulating_asset_value_dollarCirculating asset value in USD
holding_addresses_countNumber of unique holders
daily_mints_dollarDaily mint volume in USD
daily_burns_dollarDaily burn volume in USD
daily_transfer_volume_dollarDaily transfer volume in USD
apy_7_day7-day APY
apy_30_day30-day APY

​
Response format

Timeseries responses differ from list endpoints. Each result contains a measure descriptor, a group descriptor, and an array of points: 
{
  "results": [
    {
      "measure": {
        "id": 3,
        "slug": "net_asset_value_dollar",
        "name": "Net Asset Value (Dollar)",
        "unit": "dollar"
      },
      "group": {
        "id": 51,
        "type": "asset",
        "name": "Circle USYC",
        "color": "#2A3758"
      },
      "points": [
        ["2023-10-19", 1.01577],
        ["2023-10-20", 1.01590],
        ["2023-10-21", 1.01603]
      ]
    }
  ],
  "pagination": { "page": 1, "perPage": 30, "pageCount": 1, "resultCount": 1 }
}
FieldDescription
measureThe metric being returned (slug, name, unit)
groupWhat the data is grouped by — a specific asset, token, asset class, etc.
pointsArray of [date, value] pairs in chronological order

​
Examples

​
Track an asset’s NAV over time

curl -G 'https://api.rwa.xyz/v4/assets/aggregates/timeseries' \
  -H "Authorization: Bearer $RWA_API_KEY" \
  --data-urlencode 'query={
    "filter": {
      "operator": "and",
      "filters": [
        { "operator": "equals", "field": "asset_id", "value": "51" },
        { "operator": "equals", "field": "measure_slug", "value": "net_asset_value_dollar" }
      ]
    },
    "pagination": { "page": 1, "perPage": 365 }
  }'
When no aggregate block is provided, the endpoint defaults to daily granularity grouped by the entity type.

​
Compare token supply across chains

Use groupBy: "token" to get a separate series for each on-chain deployment: 
curl -G 'https://api.rwa.xyz/v4/tokens/aggregates/timeseries' \
  -H "Authorization: Bearer $RWA_API_KEY" \
  --data-urlencode 'query={
    "filter": {
      "operator": "and",
      "filters": [
        { "operator": "equals", "field": "asset_id", "value": "51" },
        { "operator": "equals", "field": "measure_slug", "value": "total_supply_token" }
      ]
    },
    "aggregate": {
      "groupBy": "token",
      "aggregateFunction": "sum",
      "interval": "day",
      "mode": "stock"
    }
  }'
This returns one series per chain (e.g., “Ethereum USYC”, “Solana USYC”, “BNB Chain USYC”), so you can see how supply is distributed across networks.

​
Aggregate an entire asset class over time

Use groupBy: "asset_class" to sum across all assets in a category: 
curl -G 'https://api.rwa.xyz/v4/assets/aggregates/timeseries' \
  -H "Authorization: Bearer $RWA_API_KEY" \
  --data-urlencode 'query={
    "filter": {
      "operator": "and",
      "filters": [
        { "operator": "equals", "field": "asset_class_name", "value": "US Treasury Debt" },
        { "operator": "equals", "field": "measure_slug", "value": "net_asset_value_dollar" }
      ]
    },
    "aggregate": {
      "groupBy": "asset_class",
      "aggregateFunction": "sum",
      "interval": "month",
      "mode": "stock"
    }
  }'
This gives you the total market size of tokenized U.S. Treasuries over time, with one data point per month.

​
Choosing the right endpoint

QuestionEndpointgroupBy
What is this asset’s total NAV over time?/v4/assets/aggregates/timeseriesasset
How is supply distributed across chains?/v4/tokens/aggregates/timeseriestoken
What’s the total market size of an asset class?/v4/assets/aggregates/timeseriesasset_class
What are daily mints per network?/v4/tokens/aggregates/timeseriesnetwork
What’s the total value of all assets combined?/v4/assets/aggregates/timeseriesdate