---
title: "A listed company's crypto treasury"
method: GET
path: "/api/market/references/{ticker}/treasury"
tags: ["public-market-data"]
---

# A listed company's crypto treasury

`GET /api/market/references/{ticker}/treasury`

## Request

- Base URL: `https://api.coinrithm.com`
- URL: `https://api.coinrithm.com/api/market/references/{ticker}/treasury`
- Auth: none required

Keyless crypto holdings (BTC, ETH, SOL, BNB) of the company behind a
catalog ticker, from the same CoinGecko data as
`/api/market/treasuries/{coin}`. Only plain US-listed equities in
the catalog can match. `treasury` is null when the company holds
none of the four coins (or is not matched); `status` combines the
four coin datasets (`fresh` when all are fresh, `unavailable` when
none is usable, otherwise `stale`), and `asOf` is the oldest
dataset read. Keep the `source` attribution next to any display.
A ticker outside the catalog returns 404.

## Path parameters

- `ticker` string, required

## Response `200`

Company holdings per coin, or a null treasury

- PublicTickerTreasuryResponse
  - `ticker` string, required
  - `status` 'fresh' | 'stale' | 'unavailable', required: Freshness of an upstream dataset CoinRithm re-reads on a schedule. `stale` data is still served inside its documented maximum age; `unavailable` means no usable copy, never zero or empty truth.
  - `treasury` PublicTickerTreasury, required
    - `name` string, required
    - `symbol` string, nullable, required
    - `country` string, nullable, required
    - `holdings` PublicTickerTreasuryHolding[], required
      - `coin` string, required
      - `holdings` number, required
      - `valueUsd` number, required
      - `pctOfSupply` number, required
  - `asOf` string, date-time, nullable, required: Oldest upstream read among the coin datasets used.
  - `source` PublicCoinGeckoAttribution, required: Keep this attribution next to any display of the data.
    - `name` string, required
    - `url` string, uri, required
    - `attribution` string, required
  - `meta` PublicFreshUntilMeta, required
    - `freshUntil` string, date-time, required: Instant until which shared caches may reuse this response.

## Other responses

- `400`: Invalid ticker or query parameter
- `404`: Reference instrument not found
- `429`: Public request rate limit exceeded; honor `Retry-After`.

---

[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)