# Crypto Stocks Tracker API
> The public stocks that give exposure to crypto, tracked live and keyless from Yahoo Finance — the Bitcoin miners, the exchanges and brokers, and the Bitcoin-treasury companies that trade as a high-beta play on the asset class. Beyond the spot ETFs, a whole complex of operating companies moves with crypto: the miners (MARA, RIOT, CleanSpark, IREN and more), the exchanges and brokers (Coinbase, Robinhood) and the treasury companies (Strategy/MSTR and others) that hold Bitcoin on their balance sheet. These equities typically move several times harder than Bitcoin itself, which makes them the high-beta way to trade the theme and a real-time read on how the market is pricing the crypto business. The stocks endpoint lists every tracked crypto-related stock, ranked by trading volume, each with its price, daily change, volume and category. The category endpoint filters to one group — miners, exchanges or treasury — with that group's average daily move, so you can see which part of the complex is leading. The stock endpoint returns one company's detail by ticker. The summary endpoint is the complex-wide read: the average move of the miners versus the exchanges versus the treasury companies, the leading sub-group and the day's biggest gainer and loser (the miners, being highest-beta, usually lead in both directions). This is the crypto-equities cut — distinct from the spot-crypto-ETF feed (passive funds that hold the coin, not operating companies), the corporate-Bitcoin-treasury feed (which reports how much BTC each company holds, not its stock price) and the coin price feeds. It tracks equity market activity (price, daily change, volume); prices and volumes are in USD. No key, nothing stored beyond a short 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/cryptostocks-api/..."
```

## Pricing
- **Free** (Free) — 850 calls/Mo, 2 req/s
- **Starter** ($21/Mo) — 23,000 calls/Mo, 6 req/s
- **Pro** ($76/Mo) — 145,000 calls/Mo, 16 req/s
- **Scale** ($221/Mo) — 580,000 calls/Mo, 40 req/s

## Endpoints

### Stocks

#### `GET /v1/stocks` — All crypto-exposure stocks ranked by volume

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

**Response:**
```json
{
    "data": {
        "note": "Every tracked crypto-exposure stock, ranked by today's trading volume — Bitcoin miners, exchanges/brokers and Bitcoin-treasury companies — each with its price, daily change, volume and category. These equities are typically a high-beta play on crypto, moving several times harder than the coin. Prices in USD. Live, cached ~10m.",
        "count": 15,
        "source": "Yahoo Finance (per-stock daily chart), keyless",
        "stocks": [
            {
                "name": "IREN LIMITED",
                "price": 59.94,
                "ticker": "IREN",
                "volume": 39242526,
                "day_low": 55.94,
                "category": "miners",
                "currency": "USD",
                "day_high": 61.4,
                "change_pct": 16.34,
                "prev_close": 51.52
            },
            {
                "name": "MARA Holdings, Inc.",
                "price": 14.06,
                "ticker": "MARA",
                "volume": 36945384,
                "day_low": 13.62,
                "category": "miners",
                "currency": "USD",
                "day_high": 14.72,
                "change_pct": 11.41,
                "prev_close": 12.62
            },
            {
                "name": "Robinhood Markets, Inc.",
                "price": 93.28,
                "ticker": "HOOD",
                "volume": 29386473,
                "day_low": 90.22,
                "category": "exchanges",
   
…(truncated, see openapi.json for full schema)
```

### Category

#### `GET /v1/category` — One sub-group (miners/exchanges/treasury) + average move

**Parameters:**
- `category` (query, required, string) — miners, exchanges or treasury Example: `miners`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptostocks-api/v1/category?category=miners"
```

**Response:**
```json
{
    "data": {
        "note": "The miners sub-group of the crypto-equity complex, ranked by volume, with the group's average daily move (avg_change_pct). Miners are the highest-beta names; exchanges track trading activity; treasury companies (like Strategy/MSTR) track their Bitcoin holdings. Prices in USD. Live, cached ~10m.",
        "count": 11,
        "source": "Yahoo Finance (per-stock daily chart), keyless",
        "stocks": [
            {
                "name": "IREN LIMITED",
                "price": 59.94,
                "ticker": "IREN",
                "volume": 39242526,
                "day_low": 55.94,
                "category": "miners",
                "currency": "USD",
                "day_high": 61.4,
                "change_pct": 16.34,
                "prev_close": 51.52
            },
            {
                "name": "MARA Holdings, Inc.",
                "price": 14.06,
                "ticker": "MARA",
                "volume": 36945384,
                "day_low": 13.62,
                "category": "miners",
                "currency": "USD",
                "day_high": 14.72,
                "change_pct": 11.41,
                "prev_close": 12.62
            },
            {
                "name": "Cipher Digital Inc.",
                "price": 24.79,
                "ticker": "CIFR",
                "volume": 22690978,
                "day_low": 22.9,
                "category": "miners",
                "currency": "USD",
             
…(truncated, see openapi.json for full schema)
```

### Stock

#### `GET /v1/stock` — One company's detail by ticker

**Parameters:**
- `ticker` (query, required, string) — A tracked crypto stock ticker Example: `MSTR`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptostocks-api/v1/stock?ticker=MSTR"
```

**Response:**
```json
{
    "data": {
        "name": "Strategy Inc",
        "note": "One crypto-exposure stock's current trading detail — price, daily change, volume and the day's high/low — with its category (miners, exchanges or treasury). Price in USD. Live, cached ~10m.",
        "price": 123.64,
        "source": "Yahoo Finance (per-stock daily chart), keyless",
        "ticker": "MSTR",
        "volume": 13697038,
        "day_low": 117.27,
        "category": "treasury",
        "currency": "USD",
        "day_high": 128.6,
        "change_pct": 7.19,
        "prev_close": 115.35
    },
    "meta": {
        "timestamp": "2026-06-12T19:35:42.355Z",
        "request_id": "c3421bd4-174b-4d4a-a8d2-088a85aecc82"
    },
    "status": "ok",
    "message": "Stock retrieved successfully",
    "success": true
}
```

### Summary

#### `GET /v1/summary` — Complex-wide read — category performance, leader, gainer/loser

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

**Response:**
```json
{
    "data": {
        "note": "The crypto-equity complex at a glance: the average daily move and volume of the miners versus the exchanges versus the treasury companies (by_category), which sub-group is leading today (leading_category), and the day's biggest gainer and loser. The miners, being highest-beta, usually lead in both directions. Volume in shares, moves in percent. Live, cached ~10m.",
        "source": "Yahoo Finance (per-stock daily chart), keyless",
        "top_loser": {
            "ticker": "BTBT",
            "change_pct": 3.24
        },
        "top_gainer": {
            "ticker": "CIFR",
            "change_pct": 17.94
        },
        "by_category": {
            "miners": {
                "count": 11,
                "total_volume": 189698117,
                "avg_change_pct": 11.11
            },
            "treasury": {
                "count": 2,
                "total_volume": 20836528,
                "avg_change_pct": 8.22
            },
            "exchanges": {
                "count": 2,
                "total_volume": 34508610,
                "avg_change_pct": 6.28
            }
        },
        "leading_category": "miners"
    },
    "meta": {
        "timestamp": "2026-06-12T19:35:42.522Z",
        "request_id": "5c8e5c8e-6151-4c6a-a2ae-d8ccbd07db62"
    },
    "status": "ok",
    "message": "Summary retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata

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

**Response:**
```json
{
    "data": {
        "note": "stocks, summary and meta take no parameters. category takes category (miners, exchanges or treasury, required). stock takes ticker (a tracked crypto stock, required). Prices and volumes are in USD. The universe is curated US-listed crypto-exposure equities; a ~10-minute cache fronts the upstream.",
        "source": "Yahoo Finance (per-stock daily chart), keyless, live",
        "service": "cryptostocks-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/stock": "One company's detail by ticker (ticker=MSTR).",
            "GET /v1/stocks": "All crypto-exposure stocks ranked by volume.",
            "GET /v1/summary": "Complex-wide read — category performance, leader, gainer/loser.",
            "GET /v1/category": "One sub-group (miners/exchanges/treasury) + its average move."
        },
        "categories": [
            "miners",
            "exchanges",
            "treasury"
        ],
        "description": "The public stocks that give exposure to crypto, tracked live and keyless from Yahoo Finance — the Bitcoin miners, the exchanges/brokers and the Bitcoin-treasury companies that trade as a high-beta play on crypto. The stocks endpoint lists every tracked name ranked by volume (price, change, volume, category); category filters to miners, exchanges or treasury with the group's average move; stock returns one company by ticker; summary gives the complex-wide read — miners vs exchanges vs 
…(truncated, see openapi.json for full schema)
```


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