# Upbit Korea Crypto Market Data API

> Upbit: Korea's largest crypto exchange, its markets, live tickers and daily price candles

- Vendor: `upbitkoreacryptomarketdataapi` · version 1.0 · category Crypto Market Data · tags upbit api, korea crypto api, krw bitcoin price api, crypto candles api, crypto ticker api, kimchi premium api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/upbitkoreacryptomarketdataapi
- This document: https://apiclay.com/docs/upbitkoreacryptomarketdataapi.md
- OpenAPI 3.1: https://apiclay.com/api/upbitkoreacryptomarketdataapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `upbitkoreacryptomarketdataapi`
- Updated: 2026-11-18

## About

## Upbit Korea Crypto Market Data API

The public quotation API of Upbit, South Korea's largest crypto exchange: every market (KRW, BTC and USDT pairs) with Korean and English names, live tickers with last, open, high and low price, change and 24-hour volume and value, and OHLCV candles by day, week, month or minute.

Data comes from **upbit.com** (https://upbit.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/markets`, then `/ticker?markets=KRW-BTC,KRW-ETH` and `/candles?market=KRW-BTC&amp;count=30`.

### Routes

#### GET `/markets` - Markets
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| isDetails | query | string | no | `true` adds the market warning flags. |

Returns: Array: `market` (e.g. `KRW-BTC`), `korean_name`, `english_name`, `market_warning`.

#### GET `/ticker` - Ticker
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| markets | query | string | yes | Comma-separated markets, e.g. `KRW-BTC,KRW-ETH`. |

Returns: Array: `market`, `trade_price`, `opening_price`, `high_price`, `low_price`, `prev_closing_price`, `change`, `change_rate`, `acc_trade_volume_24h`, `acc_trade_price_24h`, `highest_52_week_price`, `lowest_52_week_price`, `timestamp`.

#### GET `/candles` - Daily candles
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| market | query | string | yes | Market, e.g. `KRW-BTC`. |
| count | query | number | no | Candles, up to 200. |
| to | query | string | no | Last candle time, e.g. `2026-11-01T00:00:00Z`. |

Returns: Array: `candle_date_time_utc`, `opening_price`, `high_price`, `low_price`, `trade_price`, `candle_acc_trade_volume`, `candle_acc_trade_price`, `change_rate`.

### Caveats

- Prices are in the market's quote currency (mostly KRW).
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by upbit.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /markets — Markets
- Gateway: `GET https://api.apiclay.com/v1/api/upbitkoreacryptomarketdataapi/markets`
- Public query params: `isDetails` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /ticker — Ticker
- Gateway: `GET https://api.apiclay.com/v1/api/upbitkoreacryptomarketdataapi/ticker`
- Public query params: `markets` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /candles — Daily candles
- Gateway: `GET https://api.apiclay.com/v1/api/upbitkoreacryptomarketdataapi/candles`
- Public query params: `market` (string, required), `count` (number), `to` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/upbitkoreacryptomarketdataapi/markets" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
