Skip to content

Frequently asked questions

Let’s see if we manage to answer your questions on Nodely and Algorand.

Can our project just use the free endpoints?
Sure, as long as you are happy with our Fair Usage Policy! (See below).
What kind of projects use the free endpoints?
We have users that are :
  • NFT teams
  • DeFi
  • GameFi
  • Asset/NFT management
  • R&D individuals

Nodely helps projects of all sizes - from 0 total users to thousands of daily active users.
How does fair usage policy work?
You can get for free:
  • 30 requests per second, 10 concurrent calls and 18 transaction POSTs per second per source IP address; 5 requests per second for bot traffic (no browser Referer)
  • 128k requests or 2 GB worth of responses per IP address and per site, per UTC day
  • 1000 requests per second per site

Details: fair usage policy.
What happens if I do not respect limits?
Over a per-second or concurrency limit the API returns 429. As an IP address or a site nears its daily quota, a growing share of its requests gets 403 "Daily free API quota exceeded", and all of them do once the quota is used up, until 00:00 UTC. We reserve the right to blacklist back-end requests if they are too heavy.

To avoid getting your server based or serverless solution blacklisted, use the following strategies: stay within the daily quota; respect the 429 rate limit error and use exponential backoff before retrying; do not query for the same immutable data multiple times - cache the results and ask for fresh data (use min-round param); Repeatedly requesting with min-round=0 or 1 will get you banned; Do not make hundreds of identical requests from multiple servers/ip addresses in the same round; get yourself a rate limiting http client or library; do not generate more than 10 concurrent requests; do not generate more than 2 concurrent requests for blocks; do not generate more than 1 concurrent paginating request (with next=) .
Does backend traffic count towards soft/hard limits?
Yes. Backend and bot traffic (requests without a browser Referer or Origin) also has its own limit on the free tier: 5 requests per second per IP. Other limits still apply - GB quota, concurrent calls, etc.
Do we need to contact Nodely before we go live?
Nope. While not strictly needed it just pays of to give us a heads-up. We’ll gladly help you (free of charge) to make a successful transition to the mainnet. We can monitor the public dashboard during the launch so that you can focus on your own backend. If you are a huge success and our limits negatively impact the experience we can issue you temporary tokens that boost the limits tenfold.
There are paid options - do we need them?
The primary goal of Nodely is to help teams run their own API infrastructure. Until that happens teams decide on the paid packages when:

  • they need their own API token and usage analytics, within a daily quota of 256k requests and 4 GB (Boost, $32/month excl. VAT).
  • they need no daily quota and low-latency commercial endpoints with no added latency (Unlimited, $256/month excl. VAT).
  • they need a guarantee (SLA) and a real phone number to call in case something breaks.
  • they would like to hide the API call logs from the public dashboard
  • they need dedicated resources that have known performance characteristics
  • they need endpoints located physically next to their back-end

But mostly because Nodely has helped them become profitable and now they can afford it 🎉
Custom endpoints?
Our team hates vendor lock-in and one way to prevent this is to focus on vanilla API. Our API might be faster and less resource intensive but all the patches and designs are made public.

That’s why we offer endpoints with extra functionalities but we dedicate them only to commercial customers, and we charge them an arm a and a leg. Still interested? Contact us Some examples of custom endpoints: Endpoints that are depreciated elsewhere; Streaming endpoints to avoid polling (new blocks, filtered TXNs); Analytical endpoints; FTLBlock™ endpoints (for arbitrage bots)
What is the difference between Boost and Unlimited?
Boost ($32/month, monthly only) gives one endpoint 256k requests and 4 GB per UTC day (more in blocks of 256k requests and 4 GB a day for $32/month), 120 req/s per client IP, split across the region's edges, 50 ms or more of added latency on backend and bot requests, a 99.5 % SLO on the Algorand endpoints, the public nodely.dev hosts, one user per account, API tokens or whitelisted sites and 7-day usage analytics, plus the IPFS gateway for 1 verified site. Unlimited ($256/month, or $212/month billed annually) has no daily quota and no added latency, 600 req/s per client IP, split across the region's edges, the commercial nodely.io hosts, a 99.99 % SLO on Algorand, 3 endpoints, IP whitelisting, admin and viewer roles, a 24-hour support response target, R&D support and the IPFS gateway for any CID (5 sites per organization). Enterprise (from $512/month) has everything in Unlimited with no API rate limits and a 4-hour support response target. Boost, Unlimited and Enterprise include Ethereum, Base and Arc and time travel on mainnet. Prices are net: + 23 % VAT for buyers in Poland and EU consumers; no VAT for EU businesses with a valid VAT ID (reverse charge) and outside the EU. See pricing.
How do I get an API token?
Sign up in the Nodely portal. An organization admin picks a plan on the Billing page, then creates an endpoint and adds tokens and whitelisted sites (and, on Unlimited and Enterprise, IPs) to it. See API access and plans.
How do I send the token?
In one of the X-Algo-API-Token, X-Indexer-API-Token or X-API-Key headers. The Algorand SDKs send the first two for you when you pass the token to the algod or indexer client. See authentication.
How do browser apps authenticate without exposing a token?
Whitelist your site in the portal and verify the domain with a DNS TXT record or a file on the site. Browser requests are then recognised by their Referer header, so make sure your pages do not use Referrer-Policy: no-referrer.
When do daily quotas reset, and what happens at the limit?
Quotas count per UTC day and reset at 00:00 UTC. The free tier answers 403 "Daily free API quota exceeded". A Boost endpoint gets an X-And-Quota header and an email from 80 %, then a 429 with a JSON body ("Daily Boost quota exceeded") until the reset, unless an admin adds an overage block (Extra 256k requests and 4 GB a day) or upgrades. See quotas and rate limits.
Who can upgrade or change billing?
Organization admins: they start a subscription, add add-ons and open the Stripe billing portal. Boost has one user per account. On Unlimited and Enterprise, admins manage endpoints, tokens, sites and IPs, and viewers see them read-only.
Can my app load content from the IPFS gateway?
Yes, once your site is whitelisted. On Unlimited and Enterprise, sites verified in the portal are whitelisted automatically and can load any CID (5 sites per organization; public goods 1). Boost includes 1 verified site whitelisted automatically; extra sites $2 / month each. Free: 1 verified site authorized in the portal, within the free daily quota, with no endpoint or token. See IPFS gateway access.
How fast does support answer?
Enterprise: first response within 4 hours. Unlimited: first response within 24 hours. Boost and the free tier: best effort. Public goods projects: the community channels, tickets best effort. Response targets count calendar hours, weekends and holidays included. Email support@nodely.io. See support.
Can I query Algorand state at a past round?
Yes, with time travel: ?round= on account, asset, app and box endpoints, the versions API and simulate at a past round. Testnet is open to everyone; mainnet needs a Boost, Unlimited or Enterprise plan. See time travel.
What is Nodely?
We are a self-funded team with the aim of providing the best native, globally distributed, low latency Algorand API service.
What’s the difference between Nodely and Algonode?
There's no difference! Algonode has become Nodely, but we are the same team of of SREs that has been helping Algorand projects of all sizes become profitable. We offer the same services with ths same conditions.
Who are your investors?
We have no investors. The team pays all the bills.