# Duon Labs

> Simulation infrastructure for agentic finance. We build Voyons, a world model for markets.

Duon Labs builds AI simulation infrastructure for financial markets. Instead of point predictions, Voyons simulates thousands of plausible futures. Our API powers live deployments for funds, platforms, and autonomous agents.

## Payment

All paid endpoints support the x402 payment protocol (HTTP 402). No API key required for agents — pay per request with USDC on Base.

Flow: request a resource → receive 402 with pricing → sign payment → retry with `Payment-Signature` header → receive data + settlement proof.

Append `?quote=true` to any paid endpoint to get the price (no auth required).

Authenticated users with an API token can also pay via pre-purchased credits.

## API Base

`https://api.duonlabs.com/v1/`

## Endpoints

### Scenario Generation (paid)

`POST /v1/scenarios/generation/`

Generate scenario distributions for any supported asset. Returns thousands of simulated price paths. Cost depends on model, number of scenarios, and time steps.

Parameters: `model` (string), `n_scenarios` (int), `n_steps` (int), `inputs` (object with `asset`, `timeframe`, etc.)

### Metrics (paid)

Pre-computed intelligence derived from Voyons scenario distributions, updated every 8 hours.

- `GET /v1/metrics/latest/` — Latest metric per (pair, frequency). All fields returned by default. Filter by `pair`, `frequency`. Add `?include=trend_metrics` to include per-step trend data. `model_handle` defaults to `best`.
- `GET /v1/metrics/timeseries/` — Historical time series (max 1000 rows). Requires `fields` (numeric metrics only), `pair`, and `frequency`. `model_handle` defaults to `best`.

### Metrics (free)

- `GET /v1/metrics/summary/` — Available assets, buckets, and metric fields (metadata only)
- `GET /v1/metrics/sample/` — Sample of recent metrics (no auth required)

### Models

- `GET /v1/inference/models/` — Browse available models and access levels
- `GET /v1/inference/routes/` — Named routing handles that map to models

### Usage

- `GET /v1/usage/` — Credit usage history (authenticated)
- `GET /v1/usage/by_month/` — Monthly usage aggregates (authenticated)

### Users

- `GET /v1/users/me/` — Current user profile and balance (authenticated)

## Authentication

- **x402**: `Payment-Signature` header with signed USDC payment (no account needed)
- **Token**: `Authorization: Token <api_key>` header (get a key at https://platform.duonlabs.com)

## Supported Assets

24 major pairs including BTC, ETH, SOL, BNB, XRP, ADA, DOGE, DOT, LINK, LTC, AVAX, SUI, and others. Use `/v1/metrics/summary/` for the full current list.

## Documentation

- [OpenAPI Schema](https://api.duonlabs.com/api/schema/): Machine-readable API specification
- [API Docs](https://api.duonlabs.com/api/redoc/): Interactive documentation (ReDoc)
- [Python SDK](https://github.com/duonlabs/duonlabs): Official client library
- [Playground](https://playground.duonlabs.com): Interactive sandbox with x402 payment testing
- [Platform](https://platform.duonlabs.com): API key management and usage dashboard

## Website

- [Homepage](https://www.duonlabs.com): Company overview
- [Voyons](https://www.duonlabs.com/voyons): World model capabilities
- [x402](https://www.duonlabs.com/x402): Agent payment integration
- [Intel](https://www.duonlabs.com/hyperextropy): Live probabilistic market intelligence
- [Benchmarks](https://www.duonlabs.com/arena): Model performance leaderboard
- [Research](https://www.duonlabs.com/research): Open-source research

## Contact

- General: contact@duonlabs.com
- Enterprise: enterprise@duonlabs.com
- [GitHub](https://github.com/duonlabs)
- [X/Twitter](https://x.com/DuonLabsHQ)