Quickstart

Make your first API call in 30 seconds. No signup, no API key, no SDK required.

1. Get a quote

# Quote 0.1 ETH execution — returns fee + validity window
curl -X POST https://api.nano-labs.io/v1/quote \
  -H "Content-Type: application/json" \
  -d '{
    "chain": "ETH",
    "asset": "ETH",
    "amount": "100000000000000000"
  }'copy

// Response
{
  "ok": true,
  "quote_id": "66976b7bd9e40569b912000cfc583fd1",
  "chain": "ETH",
  "asset": "ETH",
  "amount": "100000000000000000",
  "fee_bps": 8,
  "protocol_fee": "80000000000000",
  "net": "99920000000000000",
  "expires_at": 1771959307,
  "valid_seconds": 30,
  "est_execution_seconds": 12,
  "finality": "~12s block, finalized in ~2 min",
  "permissionless": true
}

2. Execute the quote

curl -X POST https://api.nano-labs.io/v1/execute \
  -H "Content-Type: application/json" \
  -d '{
    "quote_id": "66976b7bd9e40569b912000cfc583fd1"
  }'copy

3. Track the intent

curl https://api.nano-labs.io/v1/intent/<intent_id>copy

Authentication

NanoStack is permissionless by default. All core endpoints work without an API key.

Why get an API key?

• Higher rate limits (100/min vs 20/min)
• Intent attribution (track your executions)
• Revenue analytics

Register (self-service)

curl -X POST https://api.nano-labs.io/v1/register \
  -H "Content-Type: application/json" \
  -d '{"name": "my-app", "email": "[email protected]"}'copy

Returns a key in nano_live_{32hex} format. Pass it as:

curl -H "x-api-key: nano_live_abc123..." https://api.nano-labs.io/v1/quote ...copy

Pricing

Fee is 8-15 basis points, locked at quote time for 30 seconds.

Supported Chains

Additional L2s: zkSync, Linea, Scroll, Blast, Mantle, Gnosis, Fantom, Sei

Errors

All errors return JSON with ok: false and an error field.

{
  "ok": false,
  "error": "quote_expired",
  "message": "Quote validity window (30s) has elapsed. Request a new quote."
}

POST /v1/quote No Auth

Request Body

Response

Example

curl -X POST https://api.nano-labs.io/v1/quote \
  -H "Content-Type: application/json" \
  -d '{"chain":"ETH","asset":"ETH","amount":"100000000000000000"}'

{
  "ok": true,
  "quote_id": "66976b7bd9e40569b912000cfc583fd1",
  "fee_bps": 8,
  "protocol_fee": "80000000000000",
  "net": "99920000000000000",
  "valid_seconds": 30,
  "est_execution_seconds": 12,
  "finality": "~12s block, finalized in ~2 min",
  "permissionless": true
}copy

POST /v1/execute No Auth

Request Body

Response

GET /v1/intent/{id} No Auth

Path Parameters

POST /v1/register No Auth

Request Body

Response

{
  "ok": true,
  "api_key": "nano_live_a1b2c3d4e5f6...",
  "tier": "standard",
  "rate_limit": "100/min"
}

GET /tokens No Auth

curl https://api.nano-labs.io/tokens

{
  "ok": true,
  "count": 83,
  "tokens": [
    {"symbol":"USDC","name":"USD Coin","chain":"eth","decimals":6,"contract":"A0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},
    {"symbol":"USDT","name":"Tether USD","chain":"eth","decimals":6,"contract":"dAC17F958D2ee523a2206206994597C13D831ec7"},
    ...
  ]
}copy

GET /v1/status No Auth

curl https://api.nano-labs.io/v1/status

{
  "ok": true,
  "protocol": "NanoStack",
  "service": "nanolink",
  "integrity_root": "0x...",
  "total_fees": "1543700258367523"
}copy

GET /health No Auth

curl https://api.nano-labs.io/health

{"ok": true, "service": "nanolink"}copy

GET /v1/telemetry/head No Auth

Query Parameters

Response (single frame)

{
  "seq": 12001,
  "trace_id": "1af593c6...",
  "chain": 8453,
  "chain_name": "base",
  "asset": "USDC",
  "status": "settled",
  "gross": "100000000000",
  "fee": "90000000",
  "net": "99910000000",
  "fee_bps": 9,
  "txid": "0x4f8b868...",
  "state_root": "acc2ed93...",
  "settlement_hash": "cc7b2abb..."
}copy

GET /v1/telemetry/range No Auth

GET /v1/telemetry/proof_snapshot No Auth

GET /v1/revenue/summary No Auth

curl https://api.nano-labs.io/v1/revenue/summary

{
  "ok": true,
  "total_fees": "1543700258367523",
  "integrity_root": "0x...",
  "source": "wal"
}copy

GET /v1/integrity/root No Auth

GET /v1/ofi/venues No Auth

curl https://api.nano-labs.io/v1/ofi/venues

{
  "ok": true,
  "venues": [
    "uniswap_v3", "aerodrome", "sushiswap_v3", "baseswap",
    "pancakeswap_v3", "curve", "balancer_v2", "maverick_v2",
    "woofi", "1inch", "0x", "paraswap", "odos", "kyberswap"
  ],
  "count": 14
}copy

GET /v1/ofi/volume No Auth

GET /v1/ofi/fees No Auth

Bot Integration

NanoStack exposes a structured bot API for automated integrations.

Transport: Primary realtime is wss://api.nano-labs.io/ws (secondary wss://api.nano-labs.io/v1/ws). Permanent fallback is polling /v1/bots/tick + /v1/bots/signal.

Bot Signal Example

curl https://api.nano-labs.io/v1/bots/tick


{
  "ok": true,
  "protocol": "NanoStack",
  "receipts": 12002,
  "settled": 7667,
  "provisional": 2243,
  "failed": 2092,
  "total_volume": "1929561487031326325",
  "total_fees": "1543700258367523",
  "success_rate": 0.8257,
  "fee_bps": 10
}copy

Aggregator Integrations

NanoStack is integrated with major cross-chain aggregators as a settlement provider.

curl https://api.nano-labs.io/v1/integrationscopy

CoW Protocol Solver

Interactive Playground

Try the API directly in your browser: Open Playground