# Bithumb Open API (slim)

> Bithumb, a Korean exchange, runs a REST and WebSocket Open API for KRW market data, orders, balances, deposits and withdrawals, and an official AI Trade Kit with a local MCP server, a CLI and agent skills.

- Full: https://www.anchorterminal.com/tools/bithumb.md (~8,550 tokens) · this version ~2,180 tokens · JSON https://www.anchorterminal.com/tools/bithumb.json · canonical https://www.anchorterminal.com/tools/bithumb
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · MCP: https://www.anchorterminal.com/mcp · Updated: 2026-11-04 · pricing https://www.anchorterminal.com/tools/bithumb#pricing · reviews https://www.anchorterminal.com/tools/bithumb#reviews
- Licence: CC BY 4.0, credit Anchor Terminal and link this page (https://www.anchorterminal.com/terms/#data)

**D · 50.6/100 · rank #999 of 1349 · #17 in Crypto exchanges · not agent-ready · confidence medium**


Assessment: Bithumb runs an official local MCP server with 41 tools, module selection and a read-only flag, beside a CLI with per-profile read-only gating and six agent skills, over an API with scoped one-year keys and a mandatory IP list. There is no sandbox, no status page, no documented 429 behaviour, and the fees and terms couldn't be read.

## Facts

- Kind: HTTP API · vendor: Bithumb Co., Ltd. · category: Crypto exchanges · legal entity: Bithumb Co., Ltd. · provenance 69/100
- Local only (stdio): npm `@bithumb-official/bithumb-mcp`, npm `@bithumb-official/bithumb-cli`
- Auth: API key · pricing: Pay per use · x402: no · licence: unknown
- Probe metrics: not measured yet (probes haven't run)
- Surface listed: The Open API v2.1.5 (REST at api.bithumb.com, WebSocket at ws-api.bithumb.com) with the AI Trade Kit's MCP server and CLI, read from apidocs.bithumb.com and its llms.txt, a shallow clone of bithumb-official/bithumb-ai-trade-kit, npm and the MCP registry on 3 November 2026. No account was made, no private endpoint was called and neither the MCP server nor the CLI was run
- MCP server: Official, local. `@bithumb-official/bithumb-mcp` on npm (0.8.5, 9 June 2026, MIT), stdio, 41 tools in seven modules selected with `--modules`, `--read-only` to block writes, keys from environment variables only, a local execution log. Not in the official MCP registry (its bithumb entries are a third party's io.github.mrfentmen/bithumb-mcp). The server's source is not in the kit repository
- Key permissions: Asset inquiry, order inquiry, place orders, withdrawals and others chosen at issuance; registered IP addresses required; valid one year, not extendable; up to 10 keys per account including expired; GET /v1/api_keys lists keys with expiry. KRW deposits and withdrawals through the API need a second factor. The kit's disclaimer advises against withdrawal permission and pre-registered addresses for an AI
- Rate limits: Per IP and per category, updated 27 October 2026: public 150 a second per category (candles, order book, ticker, trades, other), private 140 a second per category (orders, cancels, other), batch orders and cancels 20 a second. More than 20 orders or cancels a second on one asset may restrict the account. A breach restricts the category for a while, with no status code or header documented; limits may be lowered without notice in surges. WebSocket idle timeout about 120 seconds
- Testnet: None. The trade skill says all orders are real funds and Bithumb has no demo or simulated mode
- Countries: A Korean exchange with KRW markets, Korean identity verification and a Korean phone support line (1661-5566). No served or excluded country list was readable; the terms on bithumb.com timed out or answered a title only
- Fees: Unchecked. bithumb.com/react/info/fee/trade timed out on every attempt. The API has a deposit and withdrawal fee endpoint and the market skill reads fees
- FIX and WebSocket: WebSocket public v1 (ticker, trade, orderbook) at wss://ws-api.bithumb.com/websocket/v1 and private v2 (MyOrder, MyAsset) at /websocket/v2/private, with v1 private retired on 30 September 2026. No FIX found in the docs
- Terms on automation: The Open API terms at bithumb.com/react/terms/info-api answered a title only. The kit's disclaimer says AI orders face the same FDS and AML monitoring, abnormal or excessive short-term orders may get the key restricted without notice, automated programs should include a final confirmation step and an emergency stop, and commercial use of the kit is not permitted
- CLI and skills: `@bithumb-official/bithumb-cli` 0.8.5 with market, account, trade, twap, deposit, withdraw, config and system groups, profiles with read_only in ~/.bithumb/config.toml, --json output and an audit log. Six skills installed with `npx skills add bithumb-official/bithumb-ai-trade-kit --all`, with a read-only pre-flight gate the agent must not bypass
- Changelog: Ten notices on apidocs.bithumb.com, dated items among them Private v2 and new order types effective 30 June 2026, batch orders 20 to 30 on 20 August 2026 and the 200-market ticker cap on 13 October 2026
- Legal entity: Bithumb Co., Ltd., per the kit's disclaimer; the npm packages are maintained by bithumb-npm (developers@bithumbcorp.com). The terms on bithumb.com couldn't be read

- Scores: Reliability 34, Performance pending, Schema & documentation 64, Agent ergonomics 67, Security & auth 60, Payments & pricing 15, Task success pending, Maintenance & community 69, Transparency & trust 47 · total over the 7 assessed categories
- Why: Reliability, Read with the hosted lines. · Schema & documentation, No OpenAPI found; the reference is a readme.io site with Markdown twins, and the MCP tool schemas weren't read since the server's source isn… · Agent ergonomics, Graded on the REST API with the MCP server. · Security & auth, Keys scoped to chosen permissions, mandatory registered IPs, one-year expiry, a JWT per request and a key-list endpoint with expiry (26 of 3… · Payments & pricing, No machine payment protocol (0). · Maintenance & community, Read as a closed service. · Transparency & trust, The editorial half.
- Sources: 23, open questions: 7, both in the full twin
- Capabilities: exchange.market-data, exchange.spot-trading, exchange.balances, exchange.transfers, market.crypto
- JSON: https://www.anchorterminal.com/api/v1/tools/bithumb.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/bithumb.svg` or a link to https://www.anchorterminal.com/tools/bithumb from a page on bithumb.com or one of its subdomains, or the README at the root of github.com/bithumb-official/bithumb-ai-trade-kit, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.
- Support: https://apidocs.bithumb.com; https://apidocs.bithumb.com/docs/api-요청-수-제한-안내; more in the full twin

## Before you call it

1. Ask for a key with asset and order inquiry plus order placement only, never withdrawals, with your IP registered; keys expire after one year and a wrong IP answers 401 NotAllowIP
2. Start the server with `--modules market,account,trade --read-only` for analysis and drop `--read-only` only when the person asks to trade; deposit and withdraw modules stay off
3. Prefer the `bithumb` CLI for writes, as the skills do, and check `bithumb config show --json` for a read-only profile before any order
4. Keep the ticker's markets parameter at 200 or fewer, batch orders at 30 and cancels at 30 per request, and stay under 140 private calls a second per category
5. Retry 422 order_not_ready and 500 server_error after a pause; there is no sandbox, so start with the smallest order the market allows

## Connect

```bash
npm install -g @bithumb-official/bithumb-cli
```

```bash
curl 'https://api.bithumb.com/v1/market/all?isDetails=false'
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/bithumb

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Gemini Exchange API | BB | 74.6 | exchange.market-data, exchange.spot-trading, exchange.balances, exchange.transfers, market.crypto | https://www.anchorterminal.com/tools/gemini-exchange.min.md |
| Kraken API | BB | 71 | exchange.spot-trading, exchange.market-data, exchange.balances, exchange.transfers, market.crypto | https://www.anchorterminal.com/tools/kraken.min.md |
| OKX API | B | 64.3 | exchange.spot-trading, exchange.market-data, exchange.balances, exchange.transfers, market.crypto | https://www.anchorterminal.com/tools/okx.min.md |
| Binance API | B | 63.2 | exchange.spot-trading, exchange.market-data, exchange.balances, exchange.transfers, market.crypto | https://www.anchorterminal.com/tools/binance.min.md |
| Coinbase Advanced Trade API | C | 61.7 | exchange.spot-trading, exchange.market-data, exchange.balances, exchange.transfers, market.crypto | https://www.anchorterminal.com/tools/coinbase-advanced-trade.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)