Duon Labs Logo
x402

Probability on demand.

One HTTP request. One signed payment. Thousands of futures. Scenario distributions for 24 crypto assets, paid per request with stablecoins. No account, no API key.

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 pricing for each supported network.

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

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

Sign a payment

Your agent picks a network, 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 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

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

03 AGENTS

How Agents Use Voyons

Pre-Trade Validation

Agent queries scenario distributions before every trade. Checks probability of hitting target price, quantifies downside risk, decides position size.

POST /v1/scenarios/generation/ → P(target) > threshold → execute

Autonomous Rebalancing

Portfolio agent polls regime signals every 8 hours. Detects shifts in directional probability, adjusts allocation across assets without human intervention.

GET /v1/metrics/latest/ → regime shift detected → rebalance

Risk Monitoring

Watchdog agent continuously checks tail risk across positions. Triggers alerts or exits when probability of adverse move exceeds threshold.

GET /v1/metrics/latest/ → P(drawdown > 10%) > 30% → alert

Strategy Backtesting

Agent pulls historical probability signals and backtests trading rules against months of calibrated scenario data. No need to run your own models.

GET /v1/metrics/timeseries/ → backtest → optimize → deploy

Multi-Agent Pipelines

One agent fetches scenario data, passes it to a reasoning agent (LLM), which outputs a structured decision for an execution agent. Voyons is the data layer.

Voyons → LLM reasoning → execution agent → on-chain

On-Chain Vaults

DeFi vault agent uses Voyons scenarios to drive allocation decisions. Transparent, verifiable, and auditable. This is how HEP Vault works.

Voyons → score → allocate → execute on DEX → on-chain proof

24 assets supported. BTC, ETH, SOL, BNB, XRP, ADA, DOGE, DOT, LINK, LTC, AVAX, SUI, and more. Use /v1/metrics/summary/ for the full list.

04 TECHNICAL

Integration Details

Networks

Base (chain 8453)USDC, 6 decimals
Native EIP-3009. No approval needed.
MegaETH (chain 4326)USDm, 18 decimals
Via EIP-3009 forwarder (0x2c2d...B4). One-time ERC-20 approve of the forwarder on the USDm token (0xFAfD...E7) required before first payment.
Facilitator Meridian Meridian
Protocolx402 v1
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).

05 START

Point your agent at the API.

No signup required. Read the docs, test in the sandbox, or just send a request. x402 handles the rest.