Duon Labs Logo
Voyons Hyperextropy Live Benchmarks Research Company
Platform →
x402

Pay per request.
No API key needed.

Market simulation data for autonomous agents. Pay with USDC on Base using the x402 payment protocol by Coinbase.

API Documentation Try in Sandbox
How It Works Endpoints Get Started
01 PROTOCOL

Three-Step Payment Flow

Step 1 — Discover

Request a resource

Call any paid endpoint without authentication. The API responds with 402 Payment Required and a PAYMENT-REQUIRED header containing the price in USDC.

curl https://api.duonlabs.com/v1/metrics/latest/

→ 402 Payment Required
→ PAYMENT-REQUIRED: <base64 payment instructions>
Step 2 — Pay

Sign a USDC payment

Your agent signs the payment with its wallet key using the x402 client SDK. No account creation, no subscription — just a cryptographic signature.

# x402 SDK handles signing
payment = x402_client.create_payment(
    payment_required, wallet_key
)
Step 3 — Receive

Get data + settlement proof

Retry the request with the Payment-Signature header. The API settles the USDC payment on-chain and returns the data with a transaction receipt.

curl -H "Payment-Signature: ..." \
  https://api.duonlabs.com/v1/metrics/latest/

→ 200 OK + data
→ PAYMENT-RESPONSE: <settlement proof>
$

Price Discovery

Append ?quote=true to any paid endpoint to get the price without authentication or payment.

curl https://api.duonlabs.com/v1/metrics/latest/?quote=true
02 ENDPOINTS

What You Can Buy

Scenario Generation

Paid

Generate thousands of simulated price paths for any supported asset. Full probability distributions, not point forecasts.

POST /v1/scenarios/generation/

Cost varies by model and parameters. Use ?quote=true to check.

Latest Metrics

Paid

Latest pre-computed signals per (pair, frequency): directional scores, probability rings, confidence intervals. Updated every 8 hours.

GET /v1/metrics/latest/

Filter by pair, frequency. model_handle defaults to best. Select specific fields.

Historical Timeseries

Paid

Full historical data for any metric. Backtest your strategies against our probability signals.

GET /v1/metrics/timeseries/

Requires fields, pair, and frequency. model_handle defaults to best. Max 1000 rows.

Free Endpoints

/v1/metrics/summary/ — Available assets, buckets, and fields
/v1/metrics/sample/ — Sample of recent metrics
/v1/inference/models/ — Browse available models
03 TECHNICAL

Integration Details

Network

ChainBase (EVM)
AssetUSDC
Facilitatorpayai.network
Payment timeout300 seconds

Headers

Request: Payment-Signature
Response (402): PAYMENT-REQUIRED
Response (200): PAYMENT-RESPONSE

Standard x402 protocol. Compatible with any x402 client SDK (TypeScript, Go, Python).

Also works with API tokens

Human users and services can also authenticate with Authorization: Token <key> and pay via pre-purchased credits. Get a token at platform.duonlabs.com.

04 START

Start building

Read the API docs, test in the sandbox, or point your agent at the API and let x402 handle the rest.

API Documentation Sandbox llms.txt