APIFree

Free endpoints and info


Free (as in 🍺) Algorand API access

  • Node & Indexer APIs are FREE!
  • Vanilla API (so you can migrate to you own hosting)
  • No tokens, no setup, no surprises
  • Projects with >1MM requests monthly should include powered by Nodely.io in the dApp footer (see FAQ).

Limits

Individual user / browser / IP address

  • 45 requests/s , 10 concurrent calls
  • 5 transaction POSTs per second
  • 5GB worth of responses per day

Per project / site

  • 150 requests/s per site per region (23 regions = 3450 request/s )
  • 150 GB worth of responses per month
  • Up to 5 000 000 (5MM) requests per month

⚠️ Free endpoints add artificial 150ms (250ms for archival) delay for requests.

Highly available Algorand Endpoints

  • Cloudflare automatic geo balancing to 20 geo locations
  • Preflight acceleration (200+ locations)
  • Best for production (backend & frontend)
NetworkFull Indexer v2 APIFull Algod v2 API
MainNethttps://mainnet-idx.algonode.cloudhttps://mainnet-api.algonode.cloud

🛂 https://xna-mainnet-api.algonode.cloud (USA safe, see below)
TestNethttps://testnet-idx.algonode.cloudhttps://testnet-api.algonode.cloud
BetaNethttps://betanet-idx.algonode.cloudhttps://betanet-api.algonode.cloud

USA Safe Endpoints

Submitting mainnet transactions via infrastructure hosted in United States might pose legal questions.
Just use https://xna-mainnet-api.algonode.cloud to make sure your transactions are committed via nodes in regions outside of USA/North America/Hawaii

Ultra low latency DNS balanced Algorand Endpoints

  • Bunny.net Geo DNS balanced across 30+ locations
  • Best for dev/batch/analytics
  • Lower latencies in Africa and South America
NetworkFull Indexer v2 APIFull Algod v2 API
MainNet⚠️⚠️ commercial tiers only⚠️⚠️ commercial tiers only
TestNet⚠️ no longer provided⚠️ no longer provided
BetaNetn/an/a

Documentation

Nodely hosts vanilla Algod API and indexer API - just drop the URL in your SDK and you are good to go.
Do not add /v2 or / at the end of the endpoint.

Click on a Front-End URL to proceed to online Algod Swagger or Indexer Swagger documentation / API playground

HA endpoints
  • can be used by all Algorand SDKs
  • preflight queries are answered at the edge
  • are SSL and CORS enabled
  • are geographically balanced by Cloudflare
  • have per source IP limits of 45 rps with request shaping
  • can be used universally by frontend and backend
LL endpoints:
  • have lower latency than front HA endpoints
  • are better suited for backend
  • are geographically balanced by Bunny.net
  • have per source IP limits of 45 rps with request shaping
Latencies

Click the Keycdn report below to test the latencies yourself.

aa

API Changes

We lied - the hosted API has some minor differences:

  • our /v2/transactions/pending/{txid} is 600 times faster than vanilla implementation

Limits

The API requests are rate limited per source IP address with request shaping. A burst of 90 rps is allowed and all responses are delayed artificially to make sure that (if called sequentially) they will not exceed the quota. Queries exceeding the 90rps in burst or sustained 45rps will get HTTP 429 error.

If your code is doing synchronous (as in await) requests in sequence (one after another) then our load balancers will make sure they do not exceed 60 rps. Otherwise please make sure that parallel threads follow the rules:

  • add 100ms delay between requests
  • use no more than 5 parallel threads
  • use back off algorithm for retries in case of errors, unexpected results, loops

Nodely is able to issue temporary tokens that allow TENFOLD increase of limits in case of major events (Airdrops, Shuffles, product launch, etc)

What happens if I abuse the limits … ?

We reserve the right to automagically forward your traffic away from edge regions to central regions. This adds +200ms latency but makes sure our edges serve low-latency responses to casual users.

This defense mechanism is triggered when :

  • a single IP range generates > 25rps on average for more then 1hr
  • a single IP range generates > 10 000 requests that end up in code 429 (request limit)

We have our secret ways of identifying single source of requests even if it jumps across a pool of IP addresses 😈

Tokens

  • All APIs are accessible without any tokens.

Rulez

See FAQ for extra info on why all this is free.
Remember to mention us on your dApp if you make > 1MM req/mo.
Consider becoming a commercial customer once your project becomes profitable.

Monitoring

Anonymized logs with all requests to dedicated endpoints are available for commercial customers only through our dashboard Dashboard

Read more about our dashboard in this blog post.

Example usage in SDK

Javascript
const token = '';
const server = 'https://testnet-api.algonode.cloud';
const port = 443;
const client = new algosdk.Algodv2(token, server, port);

(async () => {
  console.log(await client.status().do());
})().catch((e) => {
  console.log(e);
});
REACH

Nodely is default API provider here :D

API geographic regions

Nodely hosts APIs in multiple regions around the World. The table below show network API availability per region.
When a region has no dedicated infra for a network the API queries are redirected to the nearest supported region.
All regions handle Free API endpoints. Full regions have the ability to host commercial API as well.

Testnet and Betanet traffic is handled Worldwide by Volume/Full regions and might have higher latencies compared to mainnet traffic.


🛂 means this region is part of “USA Safe” endpoint

Full RegionMainNetTestNetBetaNet
US-East (Ashburn)✅Free
✅Commercial
✅Freerouted to EU
US-West (Los Angeles)✅Free✅Freerouted to EU
EU-Central (Germany)✅🛂Free
✅🛂Commercial
✅Free✅Free
EU-North (Finland)✅🛂Free
✅🛂Commercial
✅Freerouted to EU
Singapore✅🛂Free
✅🛂Commercial
✅Freerouted to EU
Edge RegionMainNetTestNetBetaNet
USA (San Jose)✅Freerouted to fullrouted to EU
USA (Honolulu)✅Freerouted to fullrouted to EU
Canada (Montreal)✅Freerouted to fullrouted to EU
Mexico (Queretaro)✅Freerouted to fullrouted to EU
Australia (Melbourne)✅🛂Freerouted to fullrouted to EU
Japan (Osaka)✅🛂Freerouted to fullrouted to EU
India (Mumbai)✅🛂Freerouted to fullrouted to EU
Brasil (Vinhedo)✅🛂Freerouted to fullrouted to EU
South Africa (Johannesburg)✅🛂Freerouted to fullrouted to EU
Israel (Jerusalem)✅🛂Freerouted to fullrouted to EU
Chile (Santiago)✅🛂Freerouted to fullrouted to EU
UAE (Dubai)✅🛂Freerouted to fullrouted to EU
  • Full regions contain both edge and archive nodes & indexers
  • Edge regions serve 85% to 95% of requests locally from edge nodes/indexers and forward the rest to the closest Full region

Preflight (CORS) queries are handled locally in 200+ locations to speed up front-end API requests that generate OPTIONS requests before each call.

Secret APIs

Some secret endpoints exists but they :

  • are supported only in commercial offerings
  • are made possible with our open source code

SDKs that set Nodely as default API provider (❤️)

Compare packages

featureUnlimitedEnterpriseFree
Price$256 fixed$1024 per regionfree
Algod API
Indexer API
API analyticsshareddedicatedshared
Vanity endpoints🚫🚫
Custom tokens10
Domain whitelisting10
Unlimited queries10MM/month
Infrashareddedicatedshared
Algorand exclusive team
Patcheson schedulecustom scheduleexperimental
HA Regions232 or 323
Req per sec per project600030003000 (150 per region)
Req per sec per IP500customer def., up to 3k45
Monthly GB quota per project2 TB20TB per region150 GB
Daily GB quota per end user100 GB-5 GB
Node Ping Latency<50ms<100ms<50ms
Indexer Response latency<20ms p95<20ms p98<20ms median + 150ms/250ms
Indexer parametersall enabled, 10k resourcescustomer def.all enabled, 10k resources
SLO99.99%, 4hrs response99.95%, 1hr response
phone support
no SLO
SLA1x reimbursement10x reimbursement🚫
R&D support1hr/mo2hrs/mo🚫

Start using the API