# Crypto Treasury API
> Live data on the public companies that hold Bitcoin and Ethereum on their balance sheets, from the public CoinGecko feed. Rank every public company by how much of the coin it holds, with current and entry value, average entry price, country and share of total supply; get the aggregate corporate holdings, USD value and market-cap dominance; find a specific holder by name, ticker or country; and compare Bitcoin and Ethereum corporate treasuries side by side. The corporate crypto-treasury layer — distinct from price and exchange feeds: it answers who holds how much, and what they paid. Live, with a short 60-second upstream cache.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/cryptotreasury-api/..."
```

## Pricing
- **Free** (Free) — 3,950 calls/Mo, 2 req/s
- **Starter** ($8/Mo) — 84,000 calls/Mo, 6 req/s
- **Pro** ($22/Mo) — 455,000 calls/Mo, 15 req/s
- **Business** ($53/Mo) — 2,660,000 calls/Mo, 40 req/s

## Endpoints

### Crypto Treasury

#### `GET /v1/companies` — Public companies ranked by holdings

**Parameters:**
- `coin` (query, optional, string) — bitcoin or ethereum (default bitcoin) Example: `bitcoin`
- `limit` (query, optional, string) — Max results 1-300 (default 50) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptotreasury-api/v1/companies?coin=bitcoin&limit=50"
```

**Response:**
```json
{
    "data": {
        "coin": "bitcoin",
        "count": 50,
        "total": 175,
        "source": "CoinGecko",
        "companies": [
            {
                "name": "Strategy",
                "rank": 1,
                "symbol": "MSTR.US",
                "country": "US",
                "holdings": 845256,
                "pct_of_supply": 4.025,
                "entry_value_usd": 63968974080,
                "current_value_usd": 51892936934.81,
                "avg_entry_price_usd": 75680
            },
            {
                "name": "XXI",
                "rank": 2,
                "symbol": "XXI.US",
                "country": "US",
                "holdings": 43514,
                "pct_of_supply": 0.207,
                "entry_value_usd": 0,
                "current_value_usd": 2671461968.66,
                "avg_entry_price_usd": 0
            },
            {
                "name": "Metaplanet",
                "rank": 3,
                "symbol": "3350.T",
                "country": "JP",
                "holdings": 40177,
                "pct_of_supply": 0.191,
                "entry_value_usd": 3588937607.45,
                "current_value_usd": 2466592993.4,
                "avg_entry_price_usd": 89328.16
            },
            {
                "name": "MARA Holdings",
                "rank": 4,
                "symbol": "MARA.US",
                "country": "US",
                "holdings": 35303,
                "pct_of_supply": 0.168,

…(truncated, see openapi.json for full schema)
```

#### `GET /v1/company` — Find a holder by name, ticker or country

**Parameters:**
- `q` (query, required, string) — Search query Example: `strategy`
- `coin` (query, optional, string) — bitcoin or ethereum (default bitcoin) Example: `bitcoin`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptotreasury-api/v1/company?q=strategy&coin=bitcoin"
```

**Response:**
```json
{
    "data": {
        "coin": "bitcoin",
        "count": 3,
        "query": "strategy",
        "source": "CoinGecko",
        "companies": [
            {
                "name": "Strategy",
                "rank": 1,
                "symbol": "MSTR.US",
                "country": "US",
                "holdings": 845256,
                "pct_of_supply": 4.025,
                "entry_value_usd": 63968974080,
                "current_value_usd": 51892936934.81,
                "avg_entry_price_usd": 75680
            },
            {
                "name": "AsiaStrategy",
                "rank": 128,
                "symbol": "SORA.US",
                "country": "HK",
                "holdings": 30,
                "pct_of_supply": 0,
                "entry_value_usd": 0,
                "current_value_usd": 1841794.8,
                "avg_entry_price_usd": 0
            },
            {
                "name": "Hamak Strategy",
                "rank": 137,
                "symbol": "HAMA.L",
                "country": "VG",
                "holdings": 20,
                "pct_of_supply": 0,
                "entry_value_usd": 2355935.4,
                "current_value_usd": 1227863.2,
                "avg_entry_price_usd": 117796.77
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:14.217Z",
        "request_id": "f44636c8-4f87-4146-8371-eb5baa1e89bf"
    },
    "status": "ok",
    "message": "Company retrieved successfully",
    "succes
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/meta` — Service metadata and endpoint list

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptotreasury-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "CoinGecko public-treasury API (api.coingecko.com, live)",
        "service": "cryptotreasury-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/company": "Find a holder by name, ticker or country (coin=bitcoin, q=strategy).",
            "GET /v1/summary": "Aggregate corporate holdings, value & dominance (coin=bitcoin|ethereum).",
            "GET /v1/overview": "Bitcoin vs Ethereum corporate treasuries side by side.",
            "GET /v1/companies": "Public companies ranked by holdings (coin=bitcoin|ethereum, limit=50)."
        },
        "description": "Live data on the public companies that hold Bitcoin and Ethereum on their balance sheets, from the public CoinGecko feed. The companies endpoint ranks every public company by how much of the coin it holds, with current and entry value, average entry price, country and share of total supply; the summary endpoint returns aggregate corporate holdings, USD value and market-cap dominance; the company endpoint finds a holder by name, ticker or country; the overview endpoint compares Bitcoin and Ethereum corporate treasuries side by side. Live, no key, nothing stored. The corporate crypto-treasury layer, distinct from price and exchange feeds — it answers who holds how much, and what they paid.",
        "upstream_status": "ok",
        "bitcoin_companies": 175
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:14.309Z",
        "request_id
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/overview` — Bitcoin vs Ethereum corporate treasuries side by side

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptotreasury-api/v1/overview"
```

#### `GET /v1/summary` — Aggregate corporate holdings, value and dominance

**Parameters:**
- `coin` (query, optional, string) — bitcoin or ethereum (default bitcoin) Example: `bitcoin`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptotreasury-api/v1/summary?coin=bitcoin"
```

**Response:**
```json
{
    "data": {
        "coin": "bitcoin",
        "source": "CoinGecko",
        "top_holder": {
            "name": "Strategy",
            "symbol": "MSTR.US",
            "holdings": 845256
        },
        "total_holdings": 1277540.3313804658,
        "companies_count": 175,
        "total_value_usd": 78432238100.66,
        "market_cap_dominance": 6.08
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:17.666Z",
        "request_id": "507ac174-5d57-48c8-9f10-0ad0677eb71b"
    },
    "status": "ok",
    "message": "Summary retrieved successfully",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/cryptotreasury-api
OpenAPI spec: https://www.oanor.com/api/cryptotreasury-api/openapi.json