Skip to main content

​
What is default routing?

Default routing lets you test Uniblock’s Unified API and auto-routing features without creating an account or providing an API key. It’s designed for quick experimentation and prototyping before committing to a plan. Use default routing when you:
  • Want to test API endpoints before signing up
  • Need to prototype quickly without setup
  • Are evaluating Uniblock for your project
  • Want to demonstrate API capabilities to your team
Default routing is for testing only. It has strict rate limits and is not suitable for production use.

​
How it works

Simply make API calls to Uniblock endpoints without an API key:
No API key required
curl --location \
'https://api.uniblock.dev/uni/v1/token/balances?chainId=1&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'
What happens behind the scenes:
  1. Uniblock detects the request has no API key
  2. Routes the request through default routing pool
  3. Applies rate limits for anonymous usage
  4. Returns the response

​
Key benefits

Zero setup

No signup, no API key, no configuration. Start testing immediately.

Risk-free testing

Experiment with APIs without costs or commitments.

Rapid prototyping

Build proof-of-concepts quickly without infrastructure setup.

Full feature access

Test all Unified API endpoints and auto-routing features.

​
Rate limits

Default routing has strict limits to prevent abuse:
Limit typeValue
Requests per minute10
Requests per hour100
Requests per day500
Concurrent requests2
These limits are shared across all anonymous users. For production use, sign up for a free account to get dedicated rate limits.

​
Testing methods

​
Interactive API reference

Use the built-in playground in the documentation:
1

Navigate to any API endpoint

Go to the Unified API Reference and select an endpoint.
2

Click 'Try it!'

The blue “Try it!” button lets you test the endpoint directly in your browser.
3

Enter parameters

Fill in required parameters like chainId and address.
4

Execute request

Click execute to see the live response without any API key.

​
Uniblock Explorer

Test APIs visually with the Uniblock Explorer:
  • Search addresses across any supported chain
  • View token balances, NFTs, and transaction history
  • Explore API responses in real-time
  • Copy API calls for your own code

​
Command line

Test with curl or any HTTP client:
Get token balances
curl --location \
'https://api.uniblock.dev/uni/v1/token/balances?chainId=1&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'
Get NFTs
curl --location \
'https://api.uniblock.dev/uni/v1/nft/nfts?chainId=1&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'
Get transaction history
curl --location \
'https://api.uniblock.dev/uni/v1/transaction/history?chainId=1&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'

​
Code examples

The API reference provides code examples in multiple languages:
JavaScript/Node.js
const response = await fetch(
  'https://api.uniblock.dev/uni/v1/token/balances?chainId=1&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'
);
const data = await response.json();
console.log(data);
Python
import requests

response = requests.get(
    'https://api.uniblock.dev/uni/v1/token/balances',
    params={
        'chainId': '1',
        'address': '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'
    }
)
print(response.json())
Go
resp, err := http.Get(
    "https://api.uniblock.dev/uni/v1/token/balances?chainId=1&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
)
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))

​
What you can test

Default routing gives you access to all Unified API endpoints:

​
Token API

  • Token balances
  • Token transfers
  • Token prices
  • Token allowances

​
NFT API

  • NFT collections
  • NFT metadata
  • NFT transfers
  • Floor prices

​
Transaction API

  • Transaction history
  • Transaction receipts
  • Gas estimation

​
Market Data API

  • Token prices
  • Trading volume
  • Trending tokens

​
Scans API

  • Block explorer data
  • Contract verification
  • Address analytics
Explore all endpoints →

​
Upgrading from default routing

When you’re ready for production:
1

Create a free account

Sign up at dashboard.uniblock.dev - no credit card required.
2

Create a project

Generate your API key in the dashboard.
3

Add API key to requests

curl --location \
'https://api.uniblock.dev/uni/v1/token/balances?chainId=1&address=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb' \
--header 'x-api-key: YOUR_API_KEY'
4

Enjoy higher limits

Free tier includes:
  • 100,000 requests/month
  • Higher rate limits
  • Dashboard analytics
  • Email support
View all pricing plans →

​
Comparison: Default vs. Free tier

FeatureDefault routingFree tier (Startup)
Setup requiredNoneSign up + API key
Requests/month~15,000100,000
Rate limit10/min100/min
Auto-routing✅✅
Backup providers✅✅
Dashboard❌✅
Analytics❌✅
SupportCommunityEmail
Production use❌✅

​
Next steps

Sign up for free

Create an account to get higher limits and production access.

Quickstart guide

Follow the quickstart to build your first integration.

API reference

Explore all available endpoints and features.

Uniblock Explorer

Test APIs visually with the interactive explorer.

​
Common pitfalls

Rate limit errors - Default routing has very low rate limits. If you hit limits frequently, sign up for a free account.
Not for production - Default routing can be disabled or rate-limited at any time. Never use it in production applications.
Shared limits - Rate limits are shared across all anonymous users. During high traffic, you may experience throttling.
No SLA - Default routing has no uptime guarantees. For reliable service, use an authenticated API key.

Ready to get started with Uniblock?

Create your free account and start building with unified blockchain infrastructure across 100+ chains.

View API reference

Explore all available endpoints and interactive playgrounds

Join our community

Get help from our team and connect with other developers