# Farside — 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 and historical cryptocurrency ETF flow data — including Bitcoin, Ethereum, and Solana — covering daily inflows and outflows across all US spot ETF tickers. Retrieve fund-level metrics such as fees, staking status, seed capital, and summary statistics, plus public information on the Farside Equity Fund.

**Category:** Web3 & Onchain | **Website:** [farside.co.uk/](https://farside.co.uk/) | **Docs:** [parse.bot/marketplace/d1af202b-4969-4869-bcf2-d16d71525d36/farside-co-uk-api](https://parse.bot/marketplace/d1af202b-4969-4869-bcf2-d16d71525d36/farside-co-uk-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/farside/`
**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 bitcoin etf flows all

Get complete historical Bitcoin ETF flow data from January 2024 to present for all US spot Bitcoin ETFs. Returns daily flow amounts per ticker and summary statistics including Total breakdown per ticker. Large response covering all trading days since inception.

**Estimated cost:** Metered

_No parameters required._

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

### Get bitcoin etf flows recent

Get recent Bitcoin ETF flow data in US$m for all US spot Bitcoin ETFs. Returns the most recent trading days of daily flow amounts per ticker (IBIT, FBTC, BITB, ARKB, BTCO, EZBC, BRRR, HODL, BTCW, MSBT, GBTC, BTC) plus Total, and summary statistics including Fee, Total, Average, Maximum, and Minimum breakdowns per ticker.

**Estimated cost:** Metered

_No parameters required._

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

### Get ethereum etf flows all

Get complete historical Ethereum ETF flow data from July 2024 to present for all US spot Ethereum ETFs. Returns daily flow amounts per ticker and summary statistics including Fee, Seed, and Total breakdowns per ticker. Large response covering all trading days since inception.

**Estimated cost:** Metered

_No parameters required._

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

### Get ethereum etf flows recent

Get recent Ethereum ETF flow data in US$m for all US spot Ethereum ETFs. Returns the most recent trading days of daily flow amounts per ticker (ETHA, ETHB, FETH, ETHW, TETH, ETHV, QETH, EZET, ETHE, ETH) plus Total, and summary statistics including Fee, Seed, Total, Average, Maximum, and Minimum breakdowns per ticker.

**Estimated cost:** Metered

_No parameters required._

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

### Get fund info

Get public information and key metrics for the Farside Equity Fund, including current NAV, launch details, and service providers. The NAV key name includes the date it was last updated.

**Estimated cost:** Metered

_No parameters required._

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

### Get solana etf flows

Get Solana ETF flow data in US$m for US spot Solana ETFs. Returns daily flow amounts per ticker (BSOL, VSOL, FSOL, TSOL, SOEZ, GSOL) plus Total, and summary statistics including Fee, Seed, Total, Average, Maximum, and Minimum breakdowns per ticker.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/farside/get-solana-etf-flows \
  -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.