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

> 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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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 '{}'
```