# Feed Bithumb — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access real-time cryptocurrency market data from Bithumb Korea, including ticker prices in KRW and BTC, order books, transaction history, and candlestick charts. Stay informed with the latest notices, press releases, and trend reports directly from the exchange.

**Category:** Web3 & Onchain | **Website:** [feed.bithumb.com/](https://feed.bithumb.com/) | **Docs:** [parse.bot/marketplace/2b5cc98e-b29d-4664-a7f3-530e3d3e0133/feed-bithumb-com-api](https://parse.bot/marketplace/2b5cc98e-b29d-4664-a7f3-530e3d3e0133/feed-bithumb-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/feed-bithumb/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get all tickers btc

Fetch all BTC market trading tickers. Returns current price, volume, and fluctuation data for every cryptocurrency pair traded against BTC.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feed-bithumb/get-all-tickers-btc \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get all tickers krw

Fetch all KRW market trading tickers. Returns current price, volume, and fluctuation data for every cryptocurrency pair traded against KRW.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feed-bithumb/get-all-tickers-krw \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get candlestick

Fetch OHLCV candlestick data for a specific trading pair and time interval. Returns historical arrays of [timestamp, open, close, high, low, volume].

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `interval` | string | No | Chart interval |
| `order_currency` | string | Yes | Order currency symbol (e.g. BTC, ETH, XRP, SOL, DOGE) |
| `payment_currency` | string | Yes | Payment currency symbol: KRW or BTC |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feed-bithumb/get-candlestick \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"interval":"<string>","order_currency":"<string>","payment_currency":"<string>"}'
```

### Get notice detail

Fetch the full content of a specific notice by ID. Returns title, HTML content body, publication date, category, and attached files.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `notice_id` | string | Yes | Notice ID (numeric string, obtainable from get_notices results) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feed-bithumb/get-notice-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"notice_id":"<string>"}'
```

### Get notices

Fetch paginated list of official Bithumb notices. Supports keyword search and category filtering. Returns 30 notices per page with total count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category ID to filter notices. Known IDs: 1 (안내), 2 (신규서비스), 3 (점검), 4 (업데이트), 5 (거래유의), 6 (거래지원종료), 7 (입출금), 8 (이벤트), 9 (마켓 추가), 15 (공시), 16 (수수료 이벤트), 17 (후기) |
| `keyword` | string | No | Search keyword to filter notices by title |
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feed-bithumb/get-notices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","keyword":"<string>","page":"<integer>"}'
```

### Get orderbook

Fetch order book (depth) for a specific trading pair. Returns current bid and ask arrays with price and quantity at each level, plus a timestamp.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `order_currency` | string | Yes | Order currency symbol (e.g. BTC, ETH, XRP, SOL, DOGE) |
| `payment_currency` | string | Yes | Payment currency symbol: KRW or BTC |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feed-bithumb/get-orderbook \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"order_currency":"<string>","payment_currency":"<string>"}'
```

### Get press release detail

Fetch the full content of a specific press release by ID. Returns title, HTML content body, publication date, and attached files.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `press_id` | string | Yes | Press release ID (numeric string, obtainable from get_press_releases results) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feed-bithumb/get-press-release-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"press_id":"<string>"}'
```

### Get press releases

Fetch paginated list of Bithumb press releases. Supports keyword search. Returns 20 items per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | No | Search keyword to filter press releases by title |
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feed-bithumb/get-press-releases \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>","page":"<integer>"}'
```

### Get ticker

Fetch ticker data for a specific trading pair. Returns current opening/closing/min/max prices, traded volume, accumulated trade value, previous closing price, 24-hour volume, and 24-hour fluctuation rate.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `order_currency` | string | Yes | Order currency symbol (e.g. BTC, ETH, XRP, SOL, DOGE) |
| `payment_currency` | string | Yes | Payment currency symbol: KRW or BTC |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feed-bithumb/get-ticker \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"order_currency":"<string>","payment_currency":"<string>"}'
```

### Get transaction history

Fetch recent transaction history for a specific trading pair. Returns the most recent trades with transaction_date, type (ask/bid), units_traded, price, and total.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `order_currency` | string | Yes | Order currency symbol (e.g. BTC, ETH, XRP, SOL, DOGE) |
| `payment_currency` | string | Yes | Payment currency symbol: KRW or BTC |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feed-bithumb/get-transaction-history \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"order_currency":"<string>","payment_currency":"<string>"}'
```

### Get trend report detail

Fetch the full content of a specific trend report by ID. Returns title, HTML content body, publication date, category, and attached files.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `report_id` | string | Yes | Trend report ID (numeric string, obtainable from get_trend_reports results) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feed-bithumb/get-trend-report-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"report_id":"<string>"}'
```

### Get trend reports

Fetch paginated list of crypto asset trend reports and market analysis articles. Supports keyword search. Returns 12 items per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | No | Search keyword to filter trend reports by title |
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feed-bithumb/get-trend-reports \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>","page":"<integer>"}'
```

### Search feed

Search across all feed content types (notices, press releases, trends) using a keyword. Returns first-page results from each section with total counts. Useful for cross-section discovery without making three separate calls.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | Yes | Search keyword to query across all feed sections |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/feed-bithumb/search-feed \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.