---
title: "Tracked coin directory (identity, supply and links; no prices)"
method: GET
path: "/api/coins"
tags: ["public-crypto-data"]
---

# Tracked coin directory (identity, supply and links; no prices)

`GET /api/coins`

## Request

- Base URL: `https://api.coinrithm.com`
- URL: `https://api.coinrithm.com/api/coins`
- Auth: none required

Keyless page of CoinRithm's coin directory, ordered by market-cap rank
(unranked coins last) and then by `ucid`. Rows carry identity, supply,
links, categories and chains but NO price: read prices from
`/api/coins/{slug}`, `/api/coins/{slug}/price` or `/api/live-prices`.
`ucid` is the `coinId` the agent endpoints take; `slug` keys the
other public coin reads.

The directory includes inactive coins (`isActive: false`), and
`totalRows` counts every coin, active or not (cached for up to 60
seconds). `view=options` returns only `ucid`, `slug`, `name`,
`symbol`, `isActive` and `marketCapRank` per row. Unlike the coin
price reads, supply fields here are JSON numbers; `supplyMax: -1`
means the supply is uncapped.

Only `page`, `limit` and `view` are accepted; any other query
parameter returns 400 `unsupported_query_parameter`. Also served at
`/api/v1/coins` with identical behaviour.

## Query parameters

- `page` integer
- `limit` integer
- `view` 'full' | 'options'

## Response `200`

One page of the coin directory

- PublicCoinListResponse
  - `data` PublicCoinListItem[], required
    - `ucid` string, required: CoinRithm coin id, the `coinId` of the agent endpoints.
    - `externalId` string
    - `slug` string, required
    - `symbol` string, required: Ticker symbol. Symbols collide across listings; key on `ucid` or `slug`.
    - `name` string, required
    - `logoUrl` string, nullable
    - `marketCapRank` integer, nullable, required
    - `supplyCirculating` number, nullable
    - `supplyTotal` number, nullable
    - `supplyMax` number, nullable: Maximum supply; `-1` means uncapped, null unknown.
    - `websiteUrl` string, nullable
    - `socials` union: Social links, normally an array of `{url, socialId}` objects (the coin profile adds `name` and `icon`); some directory rows carry an empty object instead.
      - object[]
        - `url` string
        - `socialId` integer
        - `name` string
        - `icon` string
      - object
    - `infoLinks` object, nullable: Link groups such as `website`, `whitepaper`, `explorers`, `wallets`, `source_code` and `audit`, each an array of `{url, name}` objects.
    - `isActive` boolean, required: false for a delisted or inactive listing, which has no live price.
    - `createdAt` string, date-time
    - `updatedAt` string, date-time: Last write to the directory row (metadata), not a price time.
    - `priceHistoryValidFrom` string, date-time, nullable: Earliest time from which stored price history is considered valid, when set.
    - `categories` object[]
      - `name` string
      - `translations` object: Display name by language code (de, en, es, fr, it, nl, pt, tr).
      - `id` integer
    - `coinChains` object[]
      - `coinUcId` string
      - `chainId` integer
      - `contractAddress` string: Token contract on that chain; empty for a native coin.
      - `chain` object
        - `name` string
        - `translations` object: Display name by language code (de, en, es, fr, it, nl, pt, tr).
        - `id` integer
        - `shortName` string
        - `icon` string
  - `totalRows` integer, required: Every coin in the directory, active or not (1,704 on 2026-10-16).

## Other responses

- `400`: Invalid or missing parameters. On a route with a query allowlist, an undocumented query parameter returns `{"error": "unsupported_query_parameter", "message": "Unsupported query parameter: <key>. Supported: <keys>."}`.
- `429`: Per-IP public rate limit exceeded. Honor `Retry-After` when present, otherwise back off; `RateLimit-*` headers report the window.
- `500`: Server error

---

[API](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api.md) · [All operations](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/revisions/28fb59f285fe?raw)