> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fomoscan.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Credits and pricing

> How compute units work, what each call costs, and how to add more.

Every API call spends **compute units (CU)** from your key. One credit equals one
CU. The [partner portal](https://partner.fomoscan.sh) shows what you hold and
what you spent, and `GET /v2/me` returns the same numbers for free.

## Where credits come from

| Source | How you get it | Expiry |
| - | - | - |
| Free credits | Verify your email | 30 days after you claim them |
| Monthly plan | **Billing**, pay by card or crypto | Refill at each monthly reset while the plan is active |
| Credit pack | **Top up**, pay with crypto | Never expire |
| Invitation | An invitation link from FomoScan | Shown on the dashboard |

A free key reveals wallets for a small sample set of traders only, and those
lookups are free. Any other wallet returns `403 SAMPLE_SET_ONLY` until you pick
a plan. The [Quickstart](https://docs.fomoscan.sh/quickstart.md) lists the sample handles.

## Plans

![Monthly plans, credits drawn to a linear scale: Starter \$99 for 1M credits and 150 reveals, Builder \$299 for 5M and 500, Growth \$899 for 20M and 1,500, Scale \$2,499 for 75M and 4,000. WebSockets are included on Growth and Scale](https://mintcdn.com/socialscan/pX0brSzGgXBryxeh/images/art/plans.webp?fit=max\&auto=format\&n=pX0brSzGgXBryxeh\&q=85\&s=1fa7f5d51735afa94000d9aa31de97d0)

Choose a monthly plan on the portal's
[Billing page](https://partner.fomoscan.sh/billing), then pay by **card or crypto**
at checkout. Card subscriptions renew each month. Crypto purchases cover one
month and do not auto-renew; checkout shows the total including the crypto
processing fee.

Price per reveal is the plan price spread over its credits, for one 30,000 CU
call that returns a wallet.

| Plan | Price / month | Credits / month | Reveals / month | Price / reveal |
| - | - | - | - | - |
| Starter | \$99 | 1,000,000 | 150 | \$2.97 |
| Builder | \$299 | 5,000,000 | 500 | \$1.79 |
| Growth | \$899 | 20,000,000 | 1,500 | \$1.35 |
| Scale | \$2,499 | 75,000,000 | 4,000 | \$1.00 |
| Enterprise | Contract | Contract | Contract | Contract |

### Rate limits and WebSocket access

| Plan | Requests / minute | WebSocket access |
| - | - | - |
| Starter | 150 | Not included |
| Builder | 300 | Not included |
| Growth | 600 | Included |
| Scale | 1,200 | Included |
| Enterprise | Contract | Included |

Free credits come with 60 requests a minute and no WebSockets.

> [!NOTE]
>
> The WebSocket feeds open from the **Growth** plan. A key on a lower plan gets
> `403 WEBSOCKET_PLAN_REQUIRED` on the handshake, before the connection upgrades.

## Credit packs

One-time packs, paid with crypto under **Top up**. Pack credits never expire.

| Pack | Price |
| - | - |
| 250,000 CU | \$29 |
| 1,000,000 CU | \$115 |
| 5,000,000 CU | \$349 |
| 20,000,000 CU | \$1,049 |
| 75,000,000 CU | \$2,899 |

## What each call costs

| Endpoint | Cost |
| - | - |
| `GET /v2/user/handle/{handle}` | 100 CU on a hit, 200 CU on a 404. |
| `GET /v2/user/id/{id}` | 100 CU on a hit, 200 CU on a 404. |
| `GET /v2/user/wallet/{address}` | 30,000 CU on a hit, 200 CU on a 404. |
| `POST /v2/user/handle/{handle}/resolve` | **Paused.** 30,000 CU on a hit, 200 CU on a 202 or a 404. A paused lookup (202 with reason unavailable and retryable false) is not charged. See [Resolve on demand](https://docs.fomoscan.sh/api/identity.md#resolve-on-demand). |
| `GET /v2/user/handle/{handle}/pnl` | 30,000 CU on a hit, 200 CU on any answer that is not ready, and on a 404. |
| `POST /v2/user/handles/pnl` | 30,000 CU per entry answered ready, 200 CU per entry not ready and per handle in `missing`. |
| `GET /v2/thesis` and the thesis walls | 200 CU per 20 requested rows (`limit`, up to 100). An empty page costs the same as a full one. |
| `GET /v2/pump/*` | 10 CU per call. |
| `/v2/ws`, `/v2/ws/pump` | 20,000 CU per minute held open. |
| `GET /v2/me` | Free. |

The [API reference](https://docs.fomoscan.sh/api-reference/introduction.md) lists the price on each
endpoint and follows the running service.

## Reveals

A response that carries a wallet counts as one of the plan's monthly reveals.
`GET /v2/me` reports `usage.revealsUsed` and `usage.revealsRemaining`. At the
limit, calls return `402 REVEAL_LIMIT_REACHED`.

## Running out

```json theme={null}
{
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "out of credits - update billing on https://partner.fomoscan.sh"
  }
}
```

Calls return `402 QUOTA_EXCEEDED` until the monthly reset or a top-up. On an open
socket the same message arrives as an `error` frame, then as the reason on a
`1008` close. **Billing** in the portal lists every payment and your current
subscription.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.