Kucoin Market Data Scraper

KuCoin Market Data Scraper — Crypto Tickers, 24h Stats, and Klines

Overview

KuCoin Market Data Scraper collects publicly available cryptocurrency market data and organizes it into structured dataset records. Choose between individual spot tickers, the full ticker collection, 24-hour market statistics, or candlestick data (klines).

The actor supports configurable trading pairs, candle intervals, and collection limits. Results can be exported as JSON, CSV, or Excel through the Apify dataset for market monitoring, historical analysis, and charting workflows.

Features

• Spot ticker data: Collect the latest price, best bid and ask, and associated order sizes.
• All-tickers collection: Gather available ticker information across trading pairs.
• 24-hour market statistics: Collect available prices, trading volumes, and price-change information.
• Candlestick data: Collect market candles using a supported interval.
• Multiple trading pairs: Specify symbols such as BTC-USDT.
• Duplicate prevention: Skip duplicate pairs and duplicate candle records.
• Structured output: Store market data in flat dataset rows.
• Flexible exports: Download results as JSON, CSV, or Excel.
• Scheduled monitoring: Run the actor periodically to maintain updated market snapshots.

Use Cases

• Price monitoring: Track BTC-USDT and other spot pairs, including the latest available bid and ask.
• Market screening: Compare ticker prices, change rates, and volumes across trading pairs.
• Daily market analysis: Review available 24-hour highs, lows, average prices, and trading volumes.
• Candlestick archives: Collect hourly or other supported candles for historical charting.
• Research datasets: Prepare structured market records for Python, Pandas, spreadsheets, and data warehouses.
• Portfolio research: Monitor market indicators for selected trading pairs as part of an independent analysis workflow.

Input Parameters

Parameter	Type	Default	Description
symbols	Array of strings	["BTC-USDT"]	Trading pairs used for ticker, statistics, and candlestick collection.
mode	String	ticker	Collection mode: ticker, allTickers, stats, or klines.
klineType	String	1hour	Candlestick interval, used only in klines mode.
maxItems	Integer	100	Maximum number of successful rows to save. Hard maximum: 1,000.
requestDelaySecs	Number	0.2	Minimum delay between requests, in seconds.
timeoutSecs	Integer	300	Maximum run duration. Previously saved rows are retained when the run stops.
requestTimeoutSecs	Integer	30	Maximum wait for an individual response, in seconds.

Example Input

1. Collect the BTC-USDT ticker

{
  "symbols": ["BTC-USDT"],
  "mode": "ticker",
  "klineType": "1hour",
  "maxItems": 100,
  "requestDelaySecs": 0.2,
  "timeoutSecs": 300,
  "requestTimeoutSecs": 30
}

2. Collect 24-hour statistics for selected pairs

{
  "symbols": ["BTC-USDT", "ETH-USDT", "SOL-USDT"],
  "mode": "stats",
  "klineType": "1hour",
  "maxItems": 100,
  "requestDelaySecs": 0.2,
  "timeoutSecs": 300,
  "requestTimeoutSecs": 30
}

3. Collect all available tickers

{
  "symbols": [],
  "mode": "allTickers",
  "klineType": "1hour",
  "maxItems": 1000,
  "requestDelaySecs": 0.2,
  "timeoutSecs": 300,
  "requestTimeoutSecs": 30
}

4. Collect hourly candlestick data

{
  "symbols": ["BTC-USDT"],
  "mode": "klines",
  "klineType": "1hour",
  "maxItems": 100,
  "requestDelaySecs": 0.2,
  "timeoutSecs": 300,
  "requestTimeoutSecs": 30
}

The symbols list is used by ticker, statistics, and candlestick modes. The all-tickers mode collects the available ticker collection rather than relying on individual symbols.

What Data Does This Actor Extract?

Each successful result is stored as a flat dataset row. The fields depend on the selected collection mode and the data available for the selected trading pair.

Extracted Data Fields

Field	Type	Description
time	Integer	Exchange timestamp in milliseconds for ticker data or seconds for candle open time, depending on the mode.
sequence	String	Sequence identifier when provided by the ticker record.
price	String	Latest price reported by the individual ticker.
size	String	Last-traded size reported by the individual ticker.
bestBid	String	Best available bid price for the individual ticker.
bestBidSize	String	Size available at the best bid.
bestAsk	String	Best available ask price for the individual ticker.
bestAskSize	String	Size available at the best ask.
symbol	String	Trading pair, such as BTC-USDT.
last	String	Last price, when provided by all-tickers or statistics data.
vol	String	Trading volume, when provided by the selected market data.
changeRate	String	Price change rate, when available.
openPrice	String	Opening price field when available in the selected data.
closePrice	String	Closing price field when available in the selected data.
highPrice	String	High price field when available in the selected data.
lowPrice	String	Low price field when available in the selected data.
klineType	String	Candlestick interval associated with the record.
mode	String	Collection mode: ticker, allTickers, stats, or klines.
scraped_at	String	UTC timestamp indicating when the row was saved.

Not every field appears in every mode. The actor preserves the market data fields available for the selected collection type.

Example Output

{
  "time": 1791753818138,
  "sequence": "38527892128",
  "price": "83334.8",
  "size": "0.03155243",
  "bestBid": "83334.8",
  "bestBidSize": "0.1646019",
  "bestAsk": "83334.9",
  "bestAskSize": "0.0532125",
  "symbol": "BTC-USDT",
  "mode": "ticker",
  "scraped_at": "2026-10-12T00:00:00Z"
}

This example illustrates the individual ticker record structure. Actual prices, sizes, timestamps, and other values vary with market conditions and collection time.

Working with Your Dataset

After the run completes, open the dataset in Apify to inspect or download the collected market records.

• JSON: Useful for structured processing and application workflows.
• CSV: Suitable for Pandas, spreadsheet analysis, and data transformation.
• Excel: Convenient for reviewing market snapshots, filtering symbols, and preparing reports.

For example, use ticker records to compare bid-ask spreads, use statistics records to compare daily trading activity, or use candlestick records to prepare price charts. Check timestamps and field availability before combining data from different modes.

Important Notes

• The default mode is ticker, with BTC-USDT as the default symbol.
• Supported modes are ticker, allTickers, stats, and klines.
• Candlestick interval settings apply only to klines mode.
• The maximum number of successful rows is 1,000 per run.
• The default row limit is 100.
• All-tickers collection may return many trading pairs, so the configured row limit can restrict the saved results.
• The actor processes requests sequentially and observes the configured delay between calls.
• Duplicate pairs and duplicate candles are skipped.
• Results reflect the market information available when the actor runs; they are not guaranteed to represent current prices after collection.
• Trading-pair availability and supported candlestick intervals depend on the exchange's available market data.
• Cryptocurrency prices can change rapidly. Historical snapshots should not be treated as real-time quotes after collection.
• Market data is provided for research and analysis, not as a guarantee of future performance or investment advice.

FAQ

What collection modes are available?

The actor supports individual ticker collection, all-tickers collection, 24-hour market statistics, and candlestick data.

Can I collect several trading pairs in one run?

Yes. Provide multiple symbols, such as BTC-USDT, ETH-USDT, and SOL-USDT, for ticker, statistics, or candlestick collection.

What is the difference between ticker and all-tickers mode?

Ticker mode collects individual ticker information for the selected symbols. All-tickers mode collects the available collection of ticker records.

What does stats mode collect?

Stats mode collects available 24-hour market information, which may include high and low prices, volume, average price, and other statistics.

What is klines mode?

Klines mode collects candlestick records for selected trading pairs using the configured interval. The available intervals depend on the exchange's supported options.

How fresh is the market data?

Each run collects the information available at collection time. The scraped_at field records when a row was saved; it does not guarantee a particular exchange latency.

Can I export the results to CSV or Excel?

Yes. Apify datasets can be downloaded as JSON, CSV, or Excel.

Why did the actor save fewer rows than expected?

The maxItems setting limits successful rows. Results can also vary depending on available trading pairs, the selected mode, and the records returned during collection.

Disclaimer

This actor is an independent data-collection tool and is not affiliated with, endorsed by, sponsored by, or officially associated with KuCoin or its owners. Market data is provided for informational and research purposes. Users are responsible for evaluating the suitability of the collected information for their intended use. Nothing in the dataset constitutes financial advice or a recommendation to buy or sell cryptocurrency.

Is Web Scraping Legal?

Collecting information that is already public is generally legal. Scraping is not the same thing as hacking, and there is no single law that bans it. The limits are the usual ones: do not break into accounts, do not take private or confidential data, and be careful with personal data and copyrighted works. A site's terms can also restrict how you access it. Facts such as a public name, price, or rating are not the same thing as republishing someone's article or photo.

This actor collects information from public pages. It does not log in and it does not bypass access controls.

For a longer explanation, see Apify's article Is web scraping legal?.