Credits and pricing

Every API call spends compute units (CU) from your key. One credit equals one CU. The partner portal 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 lists the sample handles.

Plans

Choose a monthly plan on the portal’s Billing page, 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.

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.
`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 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

{
  "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.

Get started

Core concepts

Resources

Credits and pricing

Where credits come from

Plans

Rate limits and WebSocket access

Credit packs

What each call costs

Reveals

Running out

​Where credits come from

​Plans

​Rate limits and WebSocket access

​Credit packs

​What each call costs

​Reveals

​Running out

Where credits come from

Plans

Rate limits and WebSocket access

Credit packs

What each call costs

Reveals

Running out