## GET /openapi/v1/rwa/issuers

The companies that issue tokenized real-world assets, with what they have issued for the
assets we list.

`tracked_tokens`, `market_cap` and `volume_24h` can be up to 60 seconds behind the rest of the
response.

### Query parameters

| Parameter | Type | Default | Notes |
|:--|:--|:--|:--|
| `page`, `size`, `limit`, `offset` | integer | `size` 20 | As on `/assets` |
| `sort` | string | `market_cap:desc` | `market_cap`, `name`, `num_tokens`, written `<key>[:asc\|desc]`; a key with no direction is ascending, so `sort=market_cap` is smallest first. `name` ignores case. Equal values are ordered by `id` |

### Response

```json
{
  "code": 0,
  "message": "success",
  "message_key": "SUCCESS",
  "result": {
    "items": [
      {
        "id": 7,
        "name": "Ondo",
        "logo": "https://s2.coinmarketcap.com/static/img/issuer/ondo.png",
        "website": "https://ondo.finance",
        "num_tokens": 120,
        "tracked_tokens": 96,
        "market_cap": "512345678",
        "volume_24h": "23456789"
      }
    ],
    "page": 1,
    "total_page": 3,
    "total": 48
  }
}
```

#### Item fields

| Field | Type | Notes |
|:--|:--|:--|
| `id` | number | The issuer's id in this API. It identifies an issuer in these responses; no endpoint takes it as a parameter yet |
| `name` | string | |
| `logo`, `website` | string | **Empty string** when there is none |
| `num_tokens` | number | How many tokens the issuer has issued, across every asset |
| `tracked_tokens` | number | How many of those are on RWAs we list. `market_cap` and `volume_24h` are totals over these |
| `market_cap`, `volume_24h` | string or `null` | USD, summed over the tracked tokens. **`null` when no tracked token has a value** — always the case when `tracked_tokens` is `0`. Nothing to add up is not a total of zero. A `null` sorts last descending, so such issuers come last under the default order, and first under `sort=market_cap` |

### Examples

```bash
# The ten biggest issuers by tracked market cap
curl -H "X-Api-Key: <your-api-key>" \
  "https://open-api.coinworldcap.com/openapi/v1/rwa/issuers?limit=10"

# Alphabetical
curl -H "X-Api-Key: <your-api-key>" \
  "https://open-api.coinworldcap.com/openapi/v1/rwa/issuers?sort=name"
```

| HTTP status | `code` | When |
|:--|:--|:--|
| 400 | 40000 | A `sort` key outside `market_cap`, `name`, `num_tokens` (`volume_24h` included), or a malformed `sort`; the paging limits of `/assets` |

`id` and `slug` are not parameters here and are ignored. The other errors are in
[Errors](#errors).