# GET /v1/indexes/market-cap

YouPin total market cap

- Interactive docs: [https://cspriceapi.com/docs/api/indexes-market-cap](https://cspriceapi.com/docs/api/indexes-market-cap)
- OpenAPI YAML: [https://cspriceapi.com/openapi.yaml](https://cspriceapi.com/openapi.yaml)
- Data coverage: [https://cspriceapi.com/docs/data-coverage](https://cspriceapi.com/docs/data-coverage)

### GET /v1/indexes/market-cap

YouPin total market cap (Enterprise)

Daily or hourly **aggregate YouPin market cap** — the sum of
`price × listing count` across the YouPin898 catalogue, in CNY.

This is the same cleaned series shown on the public Market Index page:

- unit price must be `> 0` and `< 1,000,000` RMB (drops joke listings)
- at least **2** active listings (a single seller cannot move the index)
- only skins that exist in the internal catalogue

Daily data is cached server-side for 6 hours. Hourly data is cached for
10 minutes and reads the pre-aggregated hourly table when available.

`market_cap_rmb` is a decimal **string**. `cleaned` is `true` when the
outlier filters were applied; `false` means a fast fallback from the
precomputed daily table was used.


**Parameters**

| Name | In | Required | Description |
|---|---|---|---|
| `resolution` | query | optional | Point density. Defaults to `daily`. |
| `days` | query | optional | Lookback for `resolution=daily` (clamped to 7–365). |
| `hours` | query | optional | Lookback for `resolution=hourly` (clamped to 12–168). |

```bash
curl -s "https://api.cspriceapi.com/v1/indexes/market-cap" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

---

Full request/response schemas: import [openapi.yaml](https://cspriceapi.com/openapi.yaml) or use the Scalar UI on the HTML page.