Skip to main content
Get data about RWA assets across different platforms and networks. For a complete list of available fields, see the Assets Schema.

​
GET /v4/assets

Returns a list of assets with filtering, sorting, and pagination. Endpoint: GET /v4/assets

​
Query Parameters

  • query (optional) - JSON-encoded query object

​
Example Request

curl -G 'https://api.rwa.xyz/v4/assets' \
  -H "Authorization: Bearer $RWA_API_KEY" \
  --data-urlencode 'query={
    "filter": {
      "operator": "equals",
      "field": "asset_class_name",
      "value": "US Treasury Debt"
    },
    "sort": { "field": "circulating_market_value_dollar", "direction": "desc" },
    "pagination": { "page": 1, "perPage": 5 }
  }'

​
Example Response

{
  "results": [
    {
      "id": 51,
      "name": "Circle USYC",
      "slug": "circle-usyc",
      "ticker": "USYC",
      "asset_class_name": "US Treasury Debt",
      "issuer_name": "Circle International",
      "circulating_market_value_dollar": {
        "val": 2394947347.33,
        "val_7d": 2118658299.28,
        "chg_7d_pct": 13.04
      },
      "yield_to_maturity_percent": {
        "val": 0.0383,
        "val_7d": 0.0383
      },
      "token_count": 3,
      "network_names": ["Ethereum", "BNB Chain", "Solana"]
      // ... ~200 fields total per asset
    }
  ],
  "pagination": { "page": 1, "perPage": 5, "pageCount": 17, "resultCount": 83 }
}
Numeric metrics are returned as objects with the current value (val), historical snapshots, and percentage changes. See Responses for the full format. For a complete list of fields, see the Assets Schema.

​
GET /v4/assets/[assetID]

Returns a single asset by ID. Endpoint: GET /v4/assets/[assetID]

​
Path Parameters

  • assetID - The unique identifier for the asset

​
Example Request

curl -X GET 'https://api.rwa.xyz/v4/assets/123' \
  -H "Authorization: Bearer $RWA_API_KEY"

​
GET /v4/assets/aggregates

Returns aggregated asset data with grouping and timeseries support. Endpoint: GET /v4/assets/aggregates

​
Query Parameters

  • query - JSON-encoded query with aggregate field

​
Aggregate GroupBy Options

  • protocol_id
  • network_id
  • asset_class_id
  • date (for timeseries)

​
Example Query

{
  "aggregate": {
    "groupBy": "protocol_id",
    "aggregateFunction": "sum"
  },
  "filter": {
    "operator": "equals",
    "field": "network_slug",
    "value": "ethereum"
  }
}

​
Example Request

curl -X GET 'https://api.rwa.xyz/v4/assets/aggregates?query=%7B%22aggregate%22%3A%7B%22groupBy%22%3A%22protocol_id%22%2C%22aggregateFunction%22%3A%22sum%22%7D%7D' \
  -H "Authorization: Bearer $RWA_API_KEY"

​
GET /v4/assets/aggregates/meta

Returns metadata for the asset aggregates endpoint. Use this to discover available measures and filterable fields for timeseries queries. Endpoint: GET /v4/assets/aggregates/meta

​
Example Request

curl -X GET "https://api.rwa.xyz/v4/assets/aggregates/meta" \
  -H "Authorization: Bearer $RWA_API_KEY"

​
GET /v4/assets/aggregates/timeseries

Returns timeseries data for asset aggregates with date-based grouping. See the Timeseries & Aggregation guide for a detailed walkthrough of grouping, intervals, and modes. Endpoint: GET /v4/assets/aggregates/timeseries

​
Example Query

{
  "aggregate": {
    "groupBy": "date",
    "aggregateFunction": "sum",
    "interval": "month",
    "mode": "stock"
  }
}

​
Example Request

curl -X GET 'https://api.rwa.xyz/v4/assets/aggregates/timeseries?query=%7B%22aggregate%22%3A%7B%22groupBy%22%3A%22date%22%2C%22aggregateFunction%22%3A%22sum%22%2C%22interval%22%3A%22month%22%2C%22mode%22%3A%22stock%22%7D%7D' \
  -H "Authorization: Bearer $RWA_API_KEY"