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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-bitcointreasuries-net-api-6b0e3ae5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-bitcointreasuries-net-api-6b0e3ae5/get_all_entities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bitcointreasuries-net-api-6b0e3ae5/get_btc_price \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bitcointreasuries-net-api-6b0e3ae5/get_entity_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bitcointreasuries-net-api-6b0e3ae5/get_etf_treasuries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bitcointreasuries-net-api-6b0e3ae5/get_government_treasuries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bitcointreasuries-net-api-6b0e3ae5/get_home_summary_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bitcointreasuries-net-api-6b0e3ae5/get_news_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bitcointreasuries-net-api-6b0e3ae5/get_playground_summary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bitcointreasuries-net-api-6b0e3ae5/get_private_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bitcointreasuries-net-api-6b0e3ae5/get_public_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-bitcointreasuries-net-api-6b0e3ae5/get_top100_public_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```