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

# Field Discovery

> Discover available fields, operators, and values for any endpoint

Every resource endpoint has a corresponding `/meta` endpoint that tells you exactly which fields you can filter and sort on, what operators each field supports, and — for select fields — the valid values.

```bash theme={null}
curl -X GET 'https://api.rwa.xyz/v4/assets/meta' \
  -H "Authorization: Bearer $RWA_API_KEY"
```

The response is an array of field definitions. Each entry describes one filterable field:

```json theme={null}
[
  {
    "type": "stringSingleSelect",
    "field": "protocol_ids",
    "content": {
      "label": "Platform",
      "description": "The platform where the data originated"
    },
    "defaultOperator": "includes",
    "allowedOperators": ["includes", "not-includes"],
    "selectOptions": [
      { "value": 2, "content": { "label": "Centrifuge" } },
      { "value": 16, "content": { "label": "Ondo" } }
    ]
  },
  {
    "type": "Dollar",
    "field": "circulating_market_value_dollar",
    "content": {
      "label": "Circulating Market Value",
      "description": "..."
    },
    "defaultOperator": "gte",
    "allowedOperators": ["gt", "gte", "lt", "lte", "equals", "notEquals"]
  },
  {
    "type": "boolean",
    "field": "is_investable",
    "content": {
      "label": "Is Investable",
      "description": "Whether the asset is investable"
    },
    "defaultOperator": "equals",
    "defaultValue": true,
    "allowedOperators": ["equals", "notEquals"]
  }
  // ...
]
```

## Field types

| Type                 | Description                                                | Typical operators                                 |
| -------------------- | ---------------------------------------------------------- | ------------------------------------------------- |
| `search`             | Free-text search                                           | `like`, `notLike`                                 |
| `stringSingleSelect` | Enumerated values — check `selectOptions` for valid values | `includes`, `not-includes`, `equals`, `notEquals` |
| `Dollar`             | Dollar-denominated numeric field                           | `gt`, `gte`, `lt`, `lte`, `equals`, `notEquals`   |
| `integer`            | Integer numeric field                                      | `gt`, `gte`, `lt`, `lte`, `equals`, `notEquals`   |
| `percent`            | Percentage numeric field                                   | `gt`, `gte`, `lt`, `lte`, `equals`, `notEquals`   |
| `boolean`            | True/false field                                           | `equals`, `notEquals`                             |
| `date`               | Date field                                                 | `before`, `after`, `onOrBefore`, `onOrAfter`      |

## Timeseries meta

The aggregate endpoints have their own meta endpoints that list different fields than the base resource. For example, `/v4/tokens/aggregates/meta` returns the fields available for filtering timeseries queries — including the `measure_slug` field with all available measures as `selectOptions`:

```bash theme={null}
curl -X GET 'https://api.rwa.xyz/v4/tokens/aggregates/meta' \
  -H "Authorization: Bearer $RWA_API_KEY"
```

```json theme={null}
[
  {
    "type": "stringSingleSelect",
    "field": "measure_slug",
    "content": {
      "label": "Measure",
      "description": "The measure that's being queried"
    },
    "allowedOperators": ["equals", "notEquals"],
    "selectOptions": [
      { "value": "apy_30_day", "content": { "label": "APY (30-Day)" } },
      { "value": "net_asset_value_dollar", "content": { "label": "Net Asset Value (Dollar)" } },
      { "value": "total_supply_token", "content": { "label": "Total Supply (Token)" } }
      // ...
    ]
  },
  {
    "type": "stringSingleSelect",
    "field": "network_name",
    "content": { "label": "Network" },
    "selectOptions": [
      { "value": "Ethereum", "content": { "label": "Ethereum" } },
      { "value": "Solana", "content": { "label": "Solana" } }
      // ...
    ]
  }
  // ...
]
```

## Available meta endpoints

| Endpoint                | Meta                         |
| ----------------------- | ---------------------------- |
| `/v4/assets`            | `/v4/assets/meta`            |
| `/v4/tokens`            | `/v4/tokens/meta`            |
| `/v4/networks`          | `/v4/networks/meta`          |
| `/v4/platforms`         | `/v4/platforms/meta`         |
| `/v4/issuers`           | `/v4/issuers/meta`           |
| `/v4/managers`          | `/v4/managers/meta`          |
| `/v4/service-providers` | `/v4/service-providers/meta` |
| `/v4/transactions`      | `/v4/transactions/meta`      |
| `/v4/assets/aggregates` | `/v4/assets/aggregates/meta` |
| `/v4/tokens/aggregates` | `/v4/tokens/aggregates/meta` |
