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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.