# Bitcointalk — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 BitcoinTalk forum data to browse boards, search threads, read posts, and view user profiles all in one place. Quickly find recent discussions and explore community activity without visiting the forum directly.

**Category:** Web3 & Onchain | **Website:** [bitcointalk.org/](https://bitcointalk.org/) | **Docs:** [parse.bot/marketplace/f174cb2c-3cfe-45ee-88b4-c372f6096bfa/bitcointalk-org-api](https://parse.bot/marketplace/f174cb2c-3cfe-45ee-88b4-c372f6096bfa/bitcointalk-org-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/bitcointalk/`
**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 board threads

Retrieve a list of threads from a specific board. Returns paginated results with up to 40 threads per page. Each thread includes title, topic_id, starter username and ID, reply count, view count, and last post info. Use the start parameter to paginate in increments of 40.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `board_id` | string | Yes | Numeric ID of the board (from get_forum_boards results, e.g. '1' for Bitcoin Discussion). |
| `start` | integer | No | Pagination offset in increments of 40. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/bitcointalk/get-board-threads \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"board_id":"<string>","start":"<integer>"}'
```

### Get forum boards

Retrieve the main forum index with all categories and their boards. Returns the full hierarchy of forum categories, each containing a list of boards with metadata including board name, ID, description, post count, and topic count. This is the entry point for discovering board IDs to use with get_board_threads.

**Estimated cost:** Metered

_No parameters required._

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

### Get recent posts

Retrieve the most recent posts forum-wide. Returns paginated results with 10 posts per page. Each post includes the thread title, URL, metadata about author, and a content snippet. Use the start parameter to paginate in increments of 10.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `start` | integer | No | Pagination offset in increments of 10. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/bitcointalk/get-recent-posts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"start":"<integer>"}'
```

### Get thread posts

Retrieve all posts within a specific thread. Returns paginated results with up to 20 posts per page. Each post includes post_id, author info, timestamp, and full content text. Use the start parameter to paginate in increments of 20.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `start` | integer | No | Pagination offset in increments of 20. |
| `topic_id` | string | Yes | Numeric ID of the topic/thread (from get_board_threads results). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/bitcointalk/get-thread-posts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"start":"<integer>","topic_id":"<string>"}'
```

### Get user profile

Retrieve a user's public profile information including username, post count, activity level, merit, registration date, and last active time. Some fields may be absent if the user has not set them.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `user_id` | string | Yes | Numeric ID of the user (from thread starter_id or post author_id fields). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/bitcointalk/get-user-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"<string>"}'
```

## Next steps

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