TradingView Leaderboard Snapshot

Capture a market-movers / leaderboard snapshot into a Dataset: top gainers, losers, and other ranked tabs across stocks, crypto, forex, futures, ETFs, bonds, and indices.

Built on TradingView Data API (GET /api/leaderboard/{market}). Not official TradingView. Each run is a point-in-time snapshot — schedule the Actor if you want recurring alerts.

What you get

One leaderboard request per run, then one Dataset row per ranked name. Use it for:

• Daily “top gainers” Slack / email packs
• Dashboard tiles (price, change %, volume, market cap)
• A cheap alternative to a custom screener when you only need a named tab

market values: stocks, crypto, forex, futures, etfs, indices, bonds, corporate-bonds.

tab selects which board (gainers, losers, …). Default for stocks is stocks_market_movers.gainers. List valid tabs with:

GET https://www.tradingviewapi.com/api/metadata/tabs?type=stocks

(type is stocks, indices, crypto, futures, currencies, bonds, corporate_bonds, or etfs.)

Typical row fields: rank, symbol, name, description, exchange, price, change, volume, marketcap, sector, analystrating, plus market, tab, and scrapedAt.

How to use

1. Pick market (default stocks).
2. Set tab if you need something other than default gainers.
3. Set limit (default 50, max 200). This caps how many rows are written — it is configurable, not a hidden “5 rows only” cap.
4. Optionally pass columnset or country when the upstream tab needs them.
5. Run or schedule. Export JSON / CSV / Excel.

Example — US stock gainers

{
  "market": "stocks",
  "tab": "stocks_market_movers.gainers",
  "limit": 30
}

Input

Field	Required	Description
market	yes	stocks | crypto | forex | futures | etfs | indices | bonds | corporate-bonds
tab	no	Tab id from metadata (default stocks_market_movers.gainers)
limit	no	Max rows to push (default 50, max 200)
columnset	no	Optional upstream column set
country	no	Optional country filter

No user API key is required.

Pricing (pay per event)

Event	When
leaderboard-snapshot	Once per run
leaderboard-row	Once per row pushed

30 rows ⇒ 1× snapshot + 30× row events. Upstream may return more names than limit; extra names are discarded and not billed as rows.

Limits and notes

• Snapshot only. Rankings move; schedule the Actor for a time series.
• Most markets need a valid tab. If a run is empty, check metadata tabs for that type.
• Not investment advice. Unofficial wrapper around TradingView Data API.

Related Actors

• Screener Export — custom filters instead of a named tab
• News & Calendar Digest
• Quote + TA Batch
• Fundamentals Card