# Bitcointreasuries — 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.

> Track which companies, governments, and ETFs hold Bitcoin and monitor their portfolio sizes in real-time. Get current BTC prices, detailed entity holdings, financial metrics, and latest news across public companies, private companies, and government treasuries all in one place.

**Category:** Web3 & Onchain | **Website:** [bitcointreasuries.net/](https://bitcointreasuries.net/) | **Docs:** [parse.bot/marketplace/6b0e3ae5-1216-48a7-bf62-611c177e43f3/bitcointreasuries-net-api](https://parse.bot/marketplace/6b0e3ae5-1216-48a7-bf62-611c177e43f3/bitcointreasuries-net-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/bitcointreasuries/`
**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 entities

List all tracked Bitcoin treasury entities across all categories (Public, Private, Government, Fund, Exchange, DeFi) with their balances, metadata, and market data. Returns the complete set; no pagination needed.

**Estimated cost:** Metered

_No parameters required._

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

### Get btc price

Retrieve the current BTC/USD price along with the last daily close price and close date. Updates frequently throughout the day.

**Estimated cost:** Metered

_No parameters required._

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

### Get entity detail

Get detailed information about a specific Bitcoin treasury entity by its slug. Returns the entity overview (balance, market data, ticker), and page content (description, team, products, featured stories). Requires a valid slug obtained from get_all_entities.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The URL slug of the entity. Obtain from get_all_entities results (e.g. 'strategy', 'ishares-bitcoin-trust', 'united-states'). |

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

### Get etf treasuries

List Bitcoin holdings for ETFs and Funds. Returns all entities of type FUND with their balances, ticker symbols, and metadata.

**Estimated cost:** Metered

_No parameters required._

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

### Get government treasuries

List Bitcoin holdings for sovereign/government entities. Returns all entities of type GOVERNMENT with their balances, country, and metadata.

**Estimated cost:** Metered

_No parameters required._

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

### Get home summary stats

Aggregate summary statistics of Bitcoin holdings across all tracked entity categories (PUBLIC_COMPANY, PRIVATE_COMPANY, GOVERNMENT, FUND, EXCHANGE, DEFI). Returns BTC totals and entity counts per category, plus the current BTC price and total BTC tracked.

**Estimated cost:** Metered

_No parameters required._

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

### Get news list

Retrieve the latest Bitcoin treasury-related news articles. Returns title, description, publication date, category, image URL, and source for each article.

**Estimated cost:** Metered

_No parameters required._

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

### Get playground summary

Get aggregate financial stats for the Bitcoin treasury ecosystem based on public companies. Includes total BTC held, total market cap, average mNAV (market-cap weighted), and 24h trading volume.

**Estimated cost:** Metered

_No parameters required._

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

### Get private companies

List Bitcoin holdings for private (unlisted) companies. Returns all entities of type PRIVATE_COMPANY with their balances and metadata.

**Estimated cost:** Metered

_No parameters required._

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

### Get public companies

Retrieve rich financial data for all public companies holding Bitcoin from the Playground API. Includes BTC holdings, market cap, mNAV, returns, volatility, debt metrics, and scoring. Data comes from a separate financial analytics source with different field shapes than the main entity list.

**Estimated cost:** Metered

_No parameters required._

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

### Get top100 public companies

Get the top 100 public companies ranked by Bitcoin holdings. Returns entity data including btc_balance, ticker, market cap, and country, sorted descending by BTC balance.

**Estimated cost:** Metered

_No parameters required._

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

## 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.