Credits and reveals

v2 and v3 spend from one balance: the monthly credits, top-ups and reveal cap of your plan. Plans and credit packs are the same as on v2, in Credits and pricing.

A call that answers takes its credits from the key’s monthly balance. A free operation takes none.
A reveal is one unit of the key’s monthly reveal allowance. Operations that show who owns a wallet or what a trader earned take them, as the Reveals column says.
A refusal (400, 401, 402, 403, 429, 503) costs nothing. A 404 costs the operation’s miss price.
A metered key that cannot pay for an answer gets 402 QUOTA_EXCEEDED in its place. It is never charged past its balance.
GET /v3/me shows what is left. It is free.

“Hit” is an answer that finds its subject, “miss” one that does not. Each endpoint page lists its prices in full under Price.

Operation	Credits	Reveals
`GET /v3/traders/{traderId}`	100 hit, 200 miss	none
`GET /v3/traders/lookup`	100 hit, 200 miss	none
`GET /v3/wallets/{family}/{address}`	30,000 hit, 200 miss, 10 flat	one per hit
`GET /v3/traders/{traderId}/wallets`	100 hit, 200 miss	one when the page lists a wallet
`GET /v3/traders/{traderId}/pnl`	30,000 hit, 200 miss	one per hit
`POST /v3/traders/pnl`	30,000 per `ready` item, 200 per other item	one per `ready` item
`GET /v3/posts`	200 per started 20 rows of `limit`; 10 flat with `platform=pump`	none
`GET /v3/tokens/{network}/{address}/posts`	200 per started 20 rows of `limit`; 10 flat with `platform=pump`	none
`GET /v3/traders/{traderId}/posts`	200 per started 20 rows of `limit`; 10 flat with `platform=pump`	none
`GET /v3/tokens/{network}/{address}`	100 hit, 100 miss	none
`GET /v3/leaderboards`	free	none
`GET /v3/leaderboards/{platform}/{board}`	500 hit, 200 miss, 10 flat	none
`GET /v3/rankings`	free	none
`GET /v3/rankings/{key}`	500 hit, 200 miss	none
`GET /v3/me`	free	none
`GET /v3/capabilities`	free	none
`wss://stream.fomoscan.sh/v3`	20,000 per started minute per connection	none
`GET /v3/traders/{traderId}/followers`	200 per started 20 rows of `limit`	none
`GET /v3/traders/{traderId}/following`	200 per started 20 rows of `limit`	none
`GET /v3/trades`	200 per started 20 rows of `limit`, plus 100 per trader shown	one per trader shown
`GET /v3/traders/{traderId}/trades`	200 per started 20 rows of `limit`, plus 100 per trader shown	one per trader shown
`GET /v3/wallets/{family}/{address}/trades`	200 per started 20 rows of `limit`	none
`GET /v3/wallets/{family}/{address}/pnl`	500 hit, 200 miss	none
`POST /v3/wallets/pnl`	500 per `ready` item, 200 per other item	none

The stream is priced per socket: one token, fifty tokens or every post cost the same. See Live posts.

Get started

Core concepts

Moving from v2

Credits and reveals