---
title: "Run universe backtest, max 10 pairs (x402, $0.50)"
method: POST
path: "/api/v1/agent/backtests/universe"
tags: ["Agent (x402)"]
---

# Run universe backtest, max 10 pairs (x402, $0.50)

`POST /api/v1/agent/backtests/universe`

## Request

- Base URL: `https://tradingstrategies.work`
- URL: `https://tradingstrategies.work/api/v1/agent/backtests/universe`
- Auth: none declared

Universe-Express: run one strategy against up to 10 pairs inline. No polling. Bigger universes (Pro 50, Power 250 pairs) are available via authenticated REST/MCP — get a Free-tier key at /dashboard/account/api-keys.

**Pricing:** $0.50 USDC pay-per-call (x402). No account / no API key.
Universe-Express: up to 10 pairs in one inline call. No polling, no persistence.

## Request body

- object
  - `universe_id` string: Pre-curated universe (e.g. 'crypto-top-10') — max 10 pairs in x402-inline mode.
  - `pairs` string[]: Explicit pair list (max 10 for x402-Express).
  - `strategy` string, required
  - `interval` '1d' | '2d' | '3d' | '1w' | '1M', required
  - `date_from` string, date, required
  - `date_to` string, date
  - `capital` number
  - `params` object
  - `filters` object

## Response `200`

Settled payment + data payload.

- object

## Other responses

- `400`: Invalid input — fehlt Pflichtfeld oder Wert außerhalb des erlaubten Bereichs.
- `401`: Unauthenticated — kein gültiger Bearer-Token im Authorization-Header.
- `402`: Payment required. Body + `payment-required` header contain payment-instructions (network, payTo, amount, asset).
- `403`: Tier-Insufficient — Endpoint braucht höheren API-Tier. Response enthält upgrade_url.
- `404`: Not-Found — Resource existiert nicht oder gehört nicht dem aktuellen User.
- `429`: Rate-Limit überschritten — Tier-Quota (hourly/daily) oder Per-Endpoint-Quota erreicht. Retry-After-Header gesetzt.
- `500`: Internal Error.
- `503`: Upstream-Failure — Datenquelle nicht erreichbar (Binance, EODHD, etc.).

---

[API](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api.md) · [All operations](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tradingstrategies/apis/backtesting-arena-public-api/revisions/f82e8d6eecd7?raw)