Default routing

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:

Uniblock detects the request has no API key
Routes the request through default routing pool
Applies rate limits for anonymous usage
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 type	Value
Requests per minute	10
Requests per hour	100
Requests per day	500
Concurrent requests	2

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:

Navigate to any API endpoint

Go to the Unified API Reference and select an endpoint.

Click 'Try it!'

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

Enter parameters

Fill in required parameters like chainId and address.

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())

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:

Create a free account

Create a project

Generate your API key in the dashboard.

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'

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

Feature	Default routing	Free tier (Startup)
Setup required	None	Sign up + API key
Requests/month	~15,000	100,000
Rate limit	10/min	100/min
Auto-routing
Backup providers
Dashboard
Analytics
Support	Community	Email
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

Get Started

Uniblock

Use Cases

What is default routing?

How it works

Key benefits

Zero setup

Risk-free testing

Rapid prototyping

Full feature access

Rate limits

Testing methods

Interactive API reference

Uniblock Explorer

Command line

Code examples

What you can test

Token API

NFT API

Transaction API

Market Data API

Scans API

Upgrading from default routing

Comparison: Default vs. Free tier

Next steps

Sign up for free

Quickstart guide

API reference

Uniblock Explorer

Common pitfalls

Ready to get started with Uniblock?

View API reference

​What is default routing?

​How it works

​Key benefits

Zero setup

Risk-free testing

Rapid prototyping

Full feature access

​Rate limits

​Testing methods

​Interactive API reference

​Uniblock Explorer

​Command line

​Code examples

​What you can test

​Token API

​NFT API

​Transaction API

​Market Data API

​Scans API

​Upgrading from default routing

​Comparison: Default vs. Free tier

​Next steps

Sign up for free

Quickstart guide

API reference

Uniblock Explorer

​Common pitfalls

Ready to get started with Uniblock?

View API reference

What is default routing?

How it works

Key benefits

Rate limits

Testing methods

Interactive API reference

Uniblock Explorer

Command line

Code examples

What you can test

Token API

NFT API

Transaction API

Market Data API

Scans API

Upgrading from default routing

Comparison: Default vs. Free tier

Next steps

Common pitfalls