> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rwa.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Assets

> Asset data and aggregates endpoints

Get data about RWA assets across different platforms and networks.

For a complete list of available fields, see the [Assets Schema](/schemas/assets).

## 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

```bash theme={null}
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

```json theme={null}
{
  "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](/api/responses#metric-objects) for the full format. For a complete list of fields, see the [Assets Schema](/schemas/assets).

## 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

```bash theme={null}
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

```json theme={null}
{
  "aggregate": {
    "groupBy": "protocol_id",
    "aggregateFunction": "sum"
  },
  "filter": {
    "operator": "equals",
    "field": "network_slug",
    "value": "ethereum"
  }
}
```

### Example Request

```bash theme={null}
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](/api/meta) 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

```bash theme={null}
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](/api/timeseries) for a detailed walkthrough of grouping, intervals, and modes.

**Endpoint:** `GET /v4/assets/aggregates/timeseries`

### Example Query

```json theme={null}
{
  "aggregate": {
    "groupBy": "date",
    "aggregateFunction": "sum",
    "interval": "month",
    "mode": "stock"
  }
}
```

### Example Request

```bash theme={null}
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"
```