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

> Search hundreds of ASIC miners to compare profitability, specifications, and efficiency rankings, then get detailed insights on mining performance and market trends. Track mineable coins, solo mining odds, and cryptocurrency halving countdowns to optimize your mining strategy.

**Category:** Web3 & Onchain | **Website:** [asicminervalue.com/](https://asicminervalue.com/) | **Docs:** [parse.bot/marketplace/96b19fa1-24b3-4bde-ad95-b522784d118d/asicminervalue-com-api](https://parse.bot/marketplace/96b19fa1-24b3-4bde-ad95-b522784d118d/asicminervalue-com-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-asicminervalue-com-api-96b19fa1/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_halving_countdown

Retrieve upcoming and recent halving events for proof-of-work cryptocurrencies. Each event includes estimated halving date, target block height, blocks remaining, current and post-halving block rewards, and the mining algorithm.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-asicminervalue-com-api-96b19fa1/get_halving_countdown \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_mineable_coins

Retrieve the list of mineable coins with current market data. Each coin includes price, market cap, mining algorithm, network hashrate, and current difficulty.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-asicminervalue-com-api-96b19fa1/get_mineable_coins \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_miner_detail

Retrieve detailed specifications, profitability breakdown, mineable coins, and structured product data for a single miner identified by manufacturer and model slug. The slugs are found in the URL path on the site (e.g. /miners/bitmain/antminer-s21-200th).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `manufacturer` | string | Yes | Manufacturer slug from the URL path (e.g. 'bitmain', 'iceriver', 'goldshell'). |
| `model_slug` | string | Yes | Model slug from the URL path (e.g. 'antminer-s21-200th', 'ks3'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-asicminervalue-com-api-96b19fa1/get_miner_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"manufacturer":"<string>","model_slug":"<string>"}'
```

### get_miners_efficiency

Retrieve miners ranked by energy efficiency (J/Th, ascending). Returns the same miner fields as the profitability list but ordered by efficiency instead of power consumption.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-asicminervalue-com-api-96b19fa1/get_miners_efficiency \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_miners_profitability

Retrieve the full list of ASIC miners sorted by power consumption (ascending). Each entry includes manufacturer, model name, hashrate, power draw, daily profit estimate, algorithm, and best available price. The list represents all miners tracked by the site.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-asicminervalue-com-api-96b19fa1/get_miners_profitability \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_solo_mining_odds

Retrieve solo mining probability data for Bitcoin miners. Each entry shows hashrate, power consumption, efficiency, and the probability of finding a block per day expressed as '1 in N'.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-asicminervalue-com-api-96b19fa1/get_solo_mining_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_miners

Search for miners by keyword across the full database. Matches against miner name, slug, and manufacturer name. Returns all matching miners with their URL slugs for use with get_miner_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against miner name, slug, or manufacturer (e.g. 'antminer', 'iceriver', 'S21'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-asicminervalue-com-api-96b19fa1/search_miners \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```
