CSPriceAPI Logo

/v1/indexes/market-cap

GET

YouPin Market Cap

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

NameInRequiredDescription
resolution
string
querynoPoint density. Defaults to daily.
Example: daily
days
integer
querynoLookback for resolution=daily (clamped to 7–365).
Example: 30
hours
integer
querynoLookback for resolution=hourly (clamped to 12–168).
Example: 48

Example request

curl -s "https://api.cspriceapi.com/v1/indexes/market-cap?resolution=daily&days=30&hours=48" \
  -H "x-api-key: YOUR_API_KEY"

Example response

{
  "currency": "CNY",
  "resolution": "daily",
  "days": 30,
  "cleaned": true,
  "formula": "sum(price * listing_count)",
  "filters": {
    "max_price_rmb": 1000000,
    "min_listings": 2
  },
  "current": {
    "day": "2026-09-05",
    "market_cap_rmb": "1854321000.2500",
    "listing_count": 412003
  },
  "change_7d": "1.24",
  "change_range": "-2.10",
  "from": "2026-08-07",
  "to": "2026-09-05",
  "count": 2,
  "data": [
    {
      "day": "2026-08-07",
      "market_cap_rmb": "1894000000.0000",
      "listing_count": 401220
    },
    {
      "day": "2026-09-05",
      "market_cap_rmb": "1854321000.2500",
      "listing_count": 412003
    }
  ],
  "source": "YouPin Market Cap",
  "requestor": "customer@example.com",
  "plan": "enterprise",
  "timestamp": "2026-09-05T16:00:00.000Z"
}

Responses

  • 200Aggregate YouPin market-cap series.
  • 400Invalid parameters.
  • 401Missing, invalid, disabled or expired API key.
  • 403The API key is valid but is not allowed to call this endpoint (endpoint ACL).
  • 429Rate limit exceeded (10 requests per second per key). Retry after 1 second.
  • 500Internal server error – temporary upstream failure, etc.

Interactive explorer

Try requests with your API key and browse the full request/response schemas.

Loading endpoint…

This endpoint as Markdown (.md)