🇰🇷 Upbit Korean Crypto Exchange Scraper

🚀 Export the full Upbit market board in seconds. Pull live ticker data, Korean and English coin names, market warnings, prices, and 24h KRW or BTC volume across 740+ trading pairs on Korea's largest exchange. No API key, no signup, no localization headaches.

🕒 Last updated: 2026-05-13 · 📊 25 fields per record · 🪙 740+ markets · 🇰🇷 3 quote currencies (KRW, BTC, USDT)

The Upbit Market Scraper queries Upbit's public market list and ticker endpoints and returns 25 fields per record, including the market code, Korean and English coin names, market-warning flags, last trade price, opening price, 24h high and low, KRW or BTC volume, 52-week high and low, and timestamps. Upbit is the largest crypto exchange in South Korea by daily volume and serves as the primary on-ramp for the KRW market, which trades at a premium to global markets often called the "Kimchi premium."

The catalog covers all live spot pairs on Upbit, with KRW pairs forming the bulk of liquidity alongside smaller BTC- and USDT-quoted books. This Actor turns Upbit's split market and ticker endpoints into a single joined dataset with bilingual coin names and risk flags. Export it as CSV, Excel, JSON, or XML in under a minute. All filtering and sorting runs server-side.

🎯 Target Audience	💡 Primary Use Cases
Quant teams, Kimchi-premium analysts, KRW-market traders, fintech apps, research desks, Korean-market dashboards	Cross-border price spread monitoring, KRW premium tracking, market-warning detection, top-volume leaderboards, treasury reporting

---

📋 What the Upbit Scraper does

Four filtering workflows in a single run:

• 🌐 Full market snapshot. Every live spot pair on Upbit, joined with bilingual metadata.
• 💱 Quote filter. Restrict to KRW (the dominant book), BTC, or USDT pairs.
• 📈 Sort options. Order by 24h quote volume, base volume, percent change, last price, or market code.
• 🚨 Risk flags surfaced. Market-warning and caution flags from Upbit's investor-protection rules are returned as first-class fields.

Each record includes the canonical market code (e.g. KRW-BTC), derived base and quote assets, Korean and English coin names, any active investor warnings (price fluctuations, volume surges, deposit-amount surges, global price differences, small-account concentration), last price, opening and previous-close prices, signed and absolute change values, 24h high/low, 24h quote and base volume, 52-week high and low with dates, and Upbit's trade timestamp converted to ISO 8601.

💡 Why it matters: Upbit's ticker data is split across two endpoints with no built-in pagination on the join, and the market-warning fields are nested two levels deep. Building your own pipeline means batching ticker calls 100 markets at a time, decoding Korean Unicode, and flattening nested caution objects. This Actor does all of it and ships clean records.

---

🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset.

---

⚙️ Input

Input	Type	Default	Behavior
maxItems	integer	10	Records to return. Free plan caps at 10, paid plan at 1,000,000.
quoteCurrency	string	""	One of KRW, BTC, USDT. Empty = all markets.
sortBy	string	"accTradePrice24h"	Sort order: accTradePrice24h, accTradeVolume24h, changeRate, tradePrice, or market.

Example: top 50 KRW pairs by 24h quote volume.

{
    "maxItems": 50,
    "quoteCurrency": "KRW",
    "sortBy": "accTradePrice24h"
}

Example: every market, sorted by biggest 24h movers.

{
    "maxItems": 200,
    "quoteCurrency": "",
    "sortBy": "changeRate"
}

⚠️ Good to Know: Upbit uses the format QUOTE-BASE (e.g. KRW-BTC), the reverse of most Western exchanges. The Actor splits this so baseAsset is always the coin you are buying or selling and quoteAsset is the pricing currency. Market warnings come from Upbit's investor-protection program and are signals only, not trading bans.

---

📊 Output

Each market record contains up to 25 fields. Optional warning fields appear only when active. Download the dataset as CSV, Excel, JSON, or XML.

🧾 Schema

Field	Type	Example
🏷️ market	string	"KRW-BTC"
🔗 url	string	"https://upbit.com/exchange?code=CRIX.UPBIT.KRW-BTC"
🪙 baseAsset	string | null	"BTC"
💵 quoteAsset	string | null	"KRW"
🇰🇷 koreanName	string | null	"비트코인"
🇬🇧 englishName	string | null	"Bitcoin"
🚨 marketWarning	string | null	"CAUTION"
⚠️ cautionFlags	string[]	["DEPOSIT_AMOUNT_SOARING"]
💲 tradePrice	number | null	117799000
🔓 openingPrice	number | null	119202000
🔒 prevClosingPrice	number | null	119202000
📉 changeDirection	string | null	"FALL"
📊 changePrice	number | null	1403000
📈 changeRatePercent	number | null	1.176994
➕➖ signedChangePrice	number | null	-1403000
📐 signedChangeRatePercent	number | null	-1.176994
⬆️ high24h	number | null	120339000
⬇️ low24h	number | null	117300000
💰 accTradePrice24h	number | null	177235358856.18
📦 accTradeVolume24h	number | null	1488.097
🚀 highest52WeekPrice	number | null	179869000
📅 highest52WeekDate	string | null	"2025-10-09"
🪂 lowest52WeekPrice	number | null	89000000
📅 lowest52WeekDate	string | null	"2026-02-06"
🕒 tradeTimestamp	ISO 8601 | null	"2026-05-13T16:37:33.609Z"
🕒 scrapedAt	ISO 8601	"2026-05-13T00:00:00.000Z"

📦 Sample records

---

✨ Why choose this Actor

	Capability
🇰🇷	Korean market specialist. 740+ markets covering Upbit's full KRW, BTC, and USDT order books.
🌐	Bilingual names. Both Korean and English coin names returned per record, no translation pass required.
🚨	Investor protection signals. Market warnings and caution flags surfaced as first-class fields.
📊	Quote-volume sort. Sort directly by 24h KRW (or BTC) volume to find the most liquid markets.
⚡	Fast. Full Upbit snapshot in under 20 seconds, with batched 100-market ticker fetches.
🔁	Always fresh. Every run pulls live data from Upbit's public API.
🚫	No authentication. Works with public endpoints. No API key, no IP whitelist.

📊 The Kimchi premium is one of the most-watched anomalies in crypto. Clean Upbit data is the starting point for tracking it.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Bilingual names	Warnings	Setup
⭐ Upbit Market Scraper (this Actor)	$5 free credit, then pay-per-use	740+ markets	✅ KO + EN	✅ Built-in	⚡ 2 min
Raw Upbit API	Free	All markets	Manual decode	Nested object	🐢 Hours
Multi-venue aggregators	$50+/month	Many venues	Mixed	Rare	⏳ Days
Static market-data dumps	Free	Stale	Inconsistent	None	🕒 Variable

Pick this Actor when you want the Upbit board ready to query without writing Korean-locale parsers.

---

🚀 How to use

1. 📝 Sign up. Create a free account with $5 credit (takes 2 minutes).
2. 🌐 Open the Actor. Go to the Upbit Korean Crypto Exchange Scraper page on the Apify Store.
3. 🎯 Set input. Pick a quote currency (or leave empty for all), choose a sort order, set maxItems.
4. 🚀 Run it. Click Start and let the Actor pull the live market board.
5. 📥 Download. Grab your results in the Dataset tab as CSV, Excel, JSON, or XML.

⏱️ Total time from signup to downloaded dataset: 3-5 minutes. No coding required.

---

💼 Business use cases

💱 Kimchi premium tracking Cross-venue spread monitoring vs Binance, Coinbase KRW premium dashboards for trading desks Historical premium series for academic research Alerting when premium crosses configurable thresholds	📈 KRW market trading Top-volume KRW pair leaderboards 24h gainer or loser screens for KRW traders Order-book hygiene checks via warning flags Treasury reporting in KRW units
🇰🇷 Korean fintech and apps Bilingual coin directories with English fallback Native Korean dashboards for retail investors Localized portfolio trackers for KRW residents Compliance feeds picking up Upbit warning flags	📊 Research and analytics 52-week high or low context for technical research Market-warning frequency analysis Liquidity distribution across KRW vs BTC books Cross-currency benchmarks for global studies

---

🔌 Automating Upbit Market Scraper

Control the scraper programmatically for scheduled runs and pipeline integrations:

• 🟢 Node.js. Install the apify-client NPM package.
• 🐍 Python. Use the apify-client PyPI package.
• 📚 See the Apify API documentation for full details.

The Apify Schedules feature lets you trigger this Actor on any cron interval. Minute-level snapshots feed live dashboards, hourly captures stack into time-series stores.

---

🌟 Beyond business use cases

Korean-market crypto data powers more than commercial workflows. The same structured records support research, journalism, and personal projects.

🎓 Research and academia Cross-border crypto arbitrage studies Market-microstructure research on KRW books Investor-warning impact studies Reproducible datasets for finance coursework	🎨 Personal and creative Bilingual portfolio trackers for Korea-based traders Hobbyist dashboards for KRW pair watchers Crypto-themed visualizations for content creators Open-source tools for the Korean dev community
🤝 Non-profit and civic Consumer-protection journalism around warning flags Educational resources for retail investor literacy Open data for academic transparency efforts Audit support for Korean non-profit crypto holdings	🧪 Experimentation Train ML models on Korean-market microstructure Test alerting agents that fire on warning flags Prototype Kimchi-premium calculators Validate UI translations against live data

---

🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

---

❓ Frequently Asked Questions

🧩 How does it work?

Pick a quote currency, sort order, and maxItems, click Start, and the Actor calls Upbit's market/all endpoint for the bilingual market metadata, then batches the matching market codes 100 at a time through the ticker endpoint. The two responses are joined and flattened into clean records.

📏 How accurate is the data?

The data is the same feed Upbit serves to its trading UI. Prices reflect the moment of the run. For tick-by-tick precision schedule frequent runs.

🔁 How often is the dataset refreshed?

Every run pulls live tickers. Schedule a run every minute, every hour, or every day depending on your downstream need.

🛂 Do I need an Upbit account or API key?

No. This Actor only uses public market data endpoints, which require no authentication.

🇰🇷 What is the Kimchi premium?

It is the price gap between Korean exchanges (typically Upbit) and global exchanges, often driven by capital controls, retail sentiment, and on-ramp friction. This Actor gives you the Upbit side of that comparison.

🚨 What do the warning flags mean?

marketWarning is Upbit's top-level investor-warning status. cautionFlags is an array of granular signals: PRICE_FLUCTUATIONS, TRADING_VOLUME_SOARING, DEPOSIT_AMOUNT_SOARING, GLOBAL_PRICE_DIFFERENCES, CONCENTRATION_OF_SMALL_ACCOUNTS. These are investor-protection signals from Upbit, not trading bans.

⏰ Can I schedule regular runs?

Yes. Apify Schedules supports any cron interval. A common pattern is one snapshot per minute into a time-series store.

⚖️ Is this data legal to use?

Yes. Upbit publishes public market data under standard exchange terms. Review their terms of service for redistribution requirements.

💼 Can I use this data commercially?

Yes. Public market data from a major exchange is widely used in commercial products. Confirm Upbit's API terms cover your specific use case if you plan to redistribute the raw feed.

💳 Do I need a paid Apify plan to use this Actor?

No. The free Apify plan is enough for testing and small runs (10 records per run). A paid plan lifts the limit and unlocks scheduling and higher concurrency.

🆘 What if I need help?

Our support team is here to help. Contact us through the Apify platform or use the Tally form linked below.

---

🔌 Integrate with any app

Upbit Market Scraper connects to any cloud service via Apify integrations:

• Make - Automate multi-step workflows
• Zapier - Connect with 5,000+ apps
• Slack - Push warning-flag alerts into channels
• Airbyte - Pipe Upbit data into your warehouse
• GitHub - Trigger runs from commits and releases
• Google Drive - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes. Stream Kimchi-premium updates into a dashboard, or alert your team when a coin gets a new warning flag.

---

🔗 Recommended Actors

• 📈 FINRA BrokerCheck Scraper - U.S. broker and adviser registration records
• 💼 Pitchbook Investors Scraper - Private-market investor profiles
• 💼 Pitchbook Funds Scraper - PE and VC fund records
• 🏪 Stripe Marketplace Scraper - Fintech app marketplace catalog
• 📰 PR Newswire Scraper - Corporate and market press releases

💡 Pro Tip: browse the complete ParseForge collection for more financial and market-data scrapers.

---

🆘 Need Help? Open our contact form to request a new scraper, propose a custom data project, or report an issue.

---

⚠️ Disclaimer: this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Upbit or Dunamu Inc. All trademarks mentioned are the property of their respective owners. Only publicly available market data is collected.