> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sharpe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Market Tracker API

> Retrieve a market overview snapshot: BTC and ETH prices, Fear & Greed Index, total market cap and volume, BTC dominance, and 24h market-cap change.

The Market Tracker endpoint returns a market overview snapshot: BTC and ETH prices and 24h return, the Fear & Greed Index, total market cap and 24h volume, BTC's market share and the total market cap's 24h return. Sector and chain rows are not served by the API. Metrics refresh every 3 hours.

***

## Get market overview

`GET /v1/tracker/market-overview`

Returns the market overview dataset. No query parameters are required. The response is a flat object with BTC/ETH prices, Fear & Greed Index, total market cap, volume, and BTC dominance.

### Response fields

The response is a flat object with global market statistics.

**bitcoin** `object`

Bitcoin price data with nullable `price` and nullable `return_24h` (the 24h return, a fraction: `0.0215` is 2.15%). Missing upstream values are `null`, never fabricated as zero.

**ethereum** `object`

Ethereum price data with nullable `price` and nullable `return_24h` (the 24h return, a fraction). Missing upstream values are `null`, never fabricated as zero.

**fgi** `number | null`

Fear & Greed Index value (0 to 100), or `null` when the source is unavailable.

**fgi\_classification** `string`

Fear & Greed classification label (e.g., `Greed`, `Neutral`, `Fear`).

**total\_market\_cap** `number | null`

Total crypto market cap in USD, or `null` when unavailable.

**total\_volume** `number | null`

Total 24h trading volume in USD, or `null` when unavailable.

**btc\_market\_share** `number | null`

Bitcoin's share of total crypto market cap, 0 to 1 (`0.584` is 58.4%), or `null` when unavailable.

**market\_cap\_return\_24h** `number | null`

The total crypto market cap's return over the last 24 hours, a fraction (`0.0185` is 1.85%), or `null` when unavailable.

**updated\_at** `string`

ISO 8601 timestamp of the last data refresh.

```bash cURL theme={null}
curl -G https://www.sharpe.ai/api/v1/tracker/market-overview \
  -H "Authorization: Bearer sk_live_your_key_here"
```

```ts TypeScript theme={null}
const res = await fetch(
  'https://www.sharpe.ai/api/v1/tracker/market-overview',
  {
    headers: { Authorization: 'Bearer sk_live_your_key_here' },
  },
)
const { data } = await res.json()
```

```python Python theme={null}
import requests

resp = requests.get(
    "https://www.sharpe.ai/api/v1/tracker/market-overview",
    headers={"Authorization": "Bearer sk_live_your_key_here"},
)
data = resp.json()["data"]
```

```json Response theme={null}
{
  "data": {
    "bitcoin": {
      "price": 95200,
      "return_24h": 0.0215
    },
    "ethereum": {
      "price": 3420,
      "return_24h": 0.0138
    },
    "fgi": 72,
    "fgi_classification": "Greed",
    "total_market_cap": 3200000000000,
    "total_volume": 142000000000,
    "btc_market_share": 0.584,
    "market_cap_return_24h": 0.0185,
    "updated_at": "2026-03-28T11:50:00Z"
  },
  "meta": {
    "request_id": "req_abc123def456ghij",
    "timestamp": "2026-03-28T11:50:05Z",
    "elapsed_ms": 12
  }
}
```

[Read the error reference](https://docs.sharpe.ai/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.