# Bithumb Korea Crypto Market API

> Bithumb (South Korea) crypto prices in KRW: tickers, order book and recent trades for any coin

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

## About

## Bithumb Korea Crypto Market API

Public market data from Bithumb, one of South Korea's largest exchanges: 24h ticker (open, close, high, low, volume, change) for one coin or all coins, the order book, and the latest trades, priced in KRW or BTC.

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

Typical flow: `/ticker?pair=BTC_KRW` (or `ALL_KRW` for every coin), then `/orderbook?pair=BTC_KRW&amp;count=10` and `/trades?pair=BTC_KRW&amp;count=20`.

### Routes

#### GET `/ticker` - Ticker
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| pair | path | string | yes | `COIN_KRW` or `COIN_BTC`, e.g. `BTC_KRW`; `ALL_KRW` for all. |

Returns: `data` with `opening_price`, `closing_price`, `min_price`, `max_price`, `units_traded_24H`, `acc_trade_value_24H`, `fluctate_rate_24H`, `date`.

#### GET `/orderbook` - Order book
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| pair | path | string | yes | e.g. `BTC_KRW`. |
| count | query | number | no | Levels per side (max 30). |

Returns: `data.bids[]` / `asks[]` with `price`, `quantity`, and `timestamp`.

#### GET `/trades` - Recent trades
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| pair | path | string | yes | e.g. `BTC_KRW`. |
| count | query | number | no | Trades (max 100). |

Returns: `data[]` with `transaction_date` (KST), `type` (bid/ask), `units_traded`, `price`, `total`.

### Caveats

- Exchange market data; check Bithumb's terms before commercial redistribution. `status` `0000` means OK.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by bithumb.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 /ticker — Ticker
- Gateway: `GET https://api.apiclay.com/v1/api/bithumbkoreacryptomarketapi/ticker`
- Public query params: `pair` (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 /orderbook — Order book
- Gateway: `GET https://api.apiclay.com/v1/api/bithumbkoreacryptomarketapi/orderbook`
- Public query params: `count` (number), `pair` (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 /trades — Recent trades
- Gateway: `GET https://api.apiclay.com/v1/api/bithumbkoreacryptomarketapi/trades`
- Public query params: `count` (number), `pair` (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.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/bithumbkoreacryptomarketapi/ticker?pair=<pair>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

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