scores

Tapetide Score ranking

Every stock scored in the latest complete daily run of the Tapetide Score, a deterministic 0-100 composite of six pillars (quality, valuation, growth, momentum, financial health, ownership) with a governance overlay. Filter by band, size, sector (each accepts several values), min_score/max_score, min_confidence and q (symbol or name). Sort by band (default; best band first, the same walk as score), score, confidence, market_cap or name. Default min_confidence is 75 and the default view includes all sizes: small and micro caps can be illiquid. meta.counts reports what the filters left out and meta.applied_filters echoes them. Paging is pinned to one run: meta.next_cursor carries the run date, so a walk that started before a newer run was published keeps reading its own run (meta.snapshot.pinned_to_cursor_run is then true) instead of mixing two runs. The band matters more than the exact number: the distribution is narrow (no stock has ever scored above 77) and a 1-3 point gap is within noise. A pillar of null means the data to score it is unavailable; it is not a zero. Decision-support only. The Tapetide Score is data analysis, not investment advice. Tapetide is not a SEBI-registered research analyst or investment adviser.

get/v1/scores

Request

Base URL: https://api.tapetide.com
URL: https://api.tapetide.com/v1/scores
Auth: HTTP bearer

Query parameters

bandstring[]

Only these bands: strong, good, average, weak, poor (cutoffs 66/55/45/37). Repeat the parameter or separate with commas.

sizestring[]

Only these market-cap size buckets: large, mid, small, micro, or all (no size filter, the default). Repeat the parameter or separate with commas.

sectorstring[]

Only these sectors, as returned in sector (case-insensitive). Repeat the parameter for several (sector=A&sector=B); commas are part of a name, as in "Diamond, Gems and Jewellery". An unknown sector is a 400.

min_scoreinteger

Minimum score (inclusive).

max_scoreinteger

Maximum score (inclusive).

min_confidenceinteger

Minimum data confidence (inclusive). Default 75.

qstring

Case-insensitive substring of the symbol or company name.

sort'band' | 'score' | 'confidence' | 'market_cap' | 'name'

Sort key. band (default) and score order alike: by score, then confidence. market_cap and name put rows without a value last in both directions.

order'asc' | 'desc'

Sort direction (default desc).

limitinteger

Items per page (default 50, max 200). Values over the max are rejected, never clamped.

cursorstring

Opaque cursor from meta.next_cursor of the previous page.

Response

OK. Costs one request unit.

Example response

{
  "data": [
    {
      "symbol": "CHENNPETRO",
      "name": "Chennai Petroleum Corporation",
      "sector": "Petroleum Products",
      "industry": "Refineries & Marketing",
      "size": "mid",
      "market_cap_cr": 15230.5,
      "pe": 6.4,
      "industry_pe": 17.2,
      "score_date": "2026-10-14",
      "score": 76,
      "band": "strong",
      "confidence": 100,
      "pillars": {
        "quality": 81.2,
        "valuation": 88.4,
        "growth": 70.1,
        "momentum": 92.3,
        "financial_health": 64.9,
        "ownership": 58.7
      },
      "caps": [],
      "red_flags": []
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.