# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-feed-bithumb-com-api-2b5cc98e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-feed-bithumb-com-api-2b5cc98e/get_all_tickers_btc \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feed-bithumb-com-api-2b5cc98e/get_all_tickers_krw \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feed-bithumb-com-api-2b5cc98e/get_candlestick \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feed-bithumb-com-api-2b5cc98e/get_notice_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feed-bithumb-com-api-2b5cc98e/get_notices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feed-bithumb-com-api-2b5cc98e/get_orderbook \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feed-bithumb-com-api-2b5cc98e/get_press_release_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feed-bithumb-com-api-2b5cc98e/get_press_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feed-bithumb-com-api-2b5cc98e/get_ticker \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feed-bithumb-com-api-2b5cc98e/get_transaction_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feed-bithumb-com-api-2b5cc98e/get_trend_report_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feed-bithumb-com-api-2b5cc98e/get_trend_reports \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-feed-bithumb-com-api-2b5cc98e/search_feed \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>"}'
```