Farbeam
Docs / Reference

Limits

These values come from the server code. If a page and this table differ, report it to contact@farbeamlabs.com. No limit can be raised by payment, because nothing can be bought today. Paid plans are Planned.

#Rate limits

LimitValueNotes
Anonymous30 units per minutePer network, fixed one-minute window
With a key120 units per minutePer key, fixed one-minute window
Daily, with a key20,000 units per UTC dayPer key
Wallet overview, wallet activity, token report3 units
Transaction lookup2 units
/health, /status, /account, /me, /auth/session, /auth/logout, /keys, /account/telegram0 units
All other endpoints1 unit

Full detail is on rate limits. Counters are held in memory, so a service restart resets them.

#API keys

LimitValue
Active keys per account5
Key formatfbk_ and 48 hex characters
Label lengthCut to 60 characters
Key shownOnce, at creation
Key expiryNone. Revoke with DELETE /keys/{id} or DELETE /me.

#Wallet sign-in

LimitValue
Challenges per network30 per hour
Challenge life5 minutes, one use
Session life7 days
Telegram link life15 minutes

#Requests

LimitValue
Request body32,768 bytes
Contact form body16,384 bytes
Contact form submissions3 per 10 minutes per network
Server request timeout30 seconds

#Query parameters

EndpointParameterRangeDefault
/transferslimit1 to 10025
/transfers/statshours1 to 16824
/status/historyhours1 to 72024
/chains/{chain}/blockslimit1 to 2510
/rules/{id}/deliverieslimit1 to 10025
/transferstoken1 to 12 charactersNone

#Response caps

ResponseCap
indexed_transfers in wallet overview25 rows
Solana wallet tokensTop 60
Solana wallet recent_signatures15
Solana wallet activity25 signatures
EVM wallet activity40 items
EVM wallet activity range5,000 blocks, falling to 1,000, 200 or 40
POST /rules/validate testNewest 2,000 rows
POST /rules/validate sampleUp to 10 matches

#Streaming

LimitValue
Connections per network6
Connections in total400
Ping interval25 seconds
retry value sent5,000 ms
Retry-After on refusal30 seconds

#Rules and webhooks

LimitValue
Rules per account10
Cooldown60 to 86,400 seconds, default 300
Rule name1 to 80 characters
Expression length1,000 characters
Conditions in one expression64
Webhook URL500 characters, public HTTPS on port 443
Deliveries per rule120 per UTC hour
Test sends per rule10 per hour
Delivery attempts4 (at once, then 30 s, 5 min, 30 min)
Timeout per attempt6 seconds
Failed deliveries before a rule turns off20 in a row
Delivery workerEvery 3 seconds, 20 per pass

#Retention

DataKept
Transfers7 days, pruned hourly
Status samples30 days
Webhook deliveries14 days
Saved copies of lookups7 days
Sign-in sessions7 days
Sign-in challenges5 minutes
Sent contact messages30 days

See privacy and data for what each of these holds.

#Indexing

ItemValue
Minimum transfer stored$100,000
Log scan per poll200 blocks
Log scan catch-up limit2,000 blocks behind the head
Indexed chainsEthereum, Base, BNB Chain, Arbitrum, Solana (sampled)
Lookup-only chainsOptimism, Polygon
Labels54 entries, counted on 2026-11-04 UTC

Poll times per chain are on chain coverage.