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

# Issuers

> Asset issuer data endpoints

Get data about the entities that issue RWA assets.

## GET /v4/issuers

Returns a list of issuers with filtering, sorting, and pagination.

**Default sort:** `name` ascending | **Default page size:** 25

### Fields

| Field                                    | Type   | Filterable | Description                            |
| ---------------------------------------- | ------ | :--------: | -------------------------------------- |
| `id`                                     | string |     Yes    | Unique issuer identifier               |
| `name`                                   | string |     Yes    | Issuer name (searchable)               |
| `slug`                                   | string |     Yes    | URL-friendly identifier                |
| `description`                            | string |     Yes    | Issuer description (searchable)        |
| `icon_url`                               | string |     Yes    | Issuer logo URL                        |
| `website`                                | string |     Yes    | Issuer website                         |
| `legal_name`                             | string |     Yes    | Legal entity name (searchable)         |
| `cik`                                    | string |     Yes    | SEC Central Index Key                  |
| `lei`                                    | string |     Yes    | Legal Entity Identifier                |
| `legal_structure_type`                   | string |     Yes    | Legal structure (e.g., LLC, Trust)     |
| `legal_structure_country_id`             | number |     Yes    | Country of incorporation ID            |
| `legal_structure_country_name`           | string |     Yes    | Country of incorporation name          |
| `legal_structure_state`                  | string |     Yes    | State of incorporation                 |
| `asset_count`                            | number |     Yes    | Number of assets issued                |
| `token_count`                            | number |     Yes    | Number of tokens issued                |
| `bridged_token_value_dollar`             | number |     Yes    | Value of bridged tokens                |
| `bridged_token_market_cap_dollar`        | number |     Yes    | Market cap of bridged tokens           |
| `holding_addresses_count`                | number |     Yes    | Number of holding addresses            |
| `trailing_30_day_transfer_volume`        | number |     Yes    | Transfer volume over trailing 30 days  |
| `trailing_30_day_active_addresses_count` | number |     Yes    | Active addresses over trailing 30 days |
| `daily_mints_dollar`                     | number |     Yes    | Daily mint volume (USD)                |
| `daily_mints_token`                      | number |     Yes    | Daily mint volume (tokens)             |

### Example Request

```bash theme={null}
curl -G 'https://api.rwa.xyz/v4/issuers' \
  -H "Authorization: Bearer $RWA_API_KEY" \
  --data-urlencode 'query={
    "sort": { "field": "asset_count", "direction": "desc" },
    "pagination": { "page": 1, "perPage": 10 }
  }'
```

### Example Response

```json theme={null}
{
  "results": [
    {
      "id": 1,
      "name": "BlackRock",
      "slug": "blackrock",
      "legal_name": "BlackRock, Inc.",
      "website": "https://www.blackrock.com",
      "legal_structure_type": "Corporation",
      "legal_structure_country_name": "United States",
      "asset_count": 3,
      "token_count": 8,
      "bridged_token_value_dollar": { "val": 2500000000, "val_7d": 2400000000, "chg_7d_pct": 4.17 },
      "holding_addresses_count": { "val": 1234, "val_7d": 1200, "chg_7d_pct": 2.83 },
      "trailing_30_day_transfer_volume": { "val": 950000000, "val_7d": 920000000 },
      "trailing_30_day_active_addresses_count": { "val": 856, "val_7d": 830 },
      "daily_mints_dollar": { "val": 15000000, "val_7d": 12000000 },
      "daily_mints_token": { "val": 15100000, "val_7d": 12050000 }
    }
  ],
  "pagination": { "page": 1, "perPage": 10, "pageCount": 15, "resultCount": 142 }
}
```

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.

## GET /v4/issuers/meta

Returns [metadata](/api/meta) about available fields, filter operators, and select options for the issuers endpoint.

### Example Request

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