Public API documentation

A compact developer entry point for Strategy Arena public telemetry: AI oracle, prediction markets, live arena leaderboards, Bot Battle JSON, and CSV exports for spreadsheets.

Base URL: https://strategyarena.io JSON + CSV Paper-trading telemetry No trading execution

Quick start

Read-only public telemetry is available without account setup. Oracle endpoints use an API key created through the registration endpoint.

curl https://strategyarena.io/api/v1/bot-battle

curl "https://strategyarena.io/api/v1/bot-battle/export.csv?venue=raydium"

curl -X POST https://strategyarena.io/api/v1/register \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","app_name":"Research dashboard"}'

All trading and LP data is research/paper telemetry unless an endpoint explicitly says otherwise. It is not investment advice.

Authentication

Endpoint family	Auth	Notes
`/api/v1/oracle`	`X-API-Key`	Register first with `/api/v1/register`.
`/api/v1/predictions`	`X-API-Key`	Uses the public API key quota.
`/api/v1/leaderboard`	`X-API-Key`	Use `asset=btc`, `eth`, `sol`, `bnb`, `gold`, or `silver`.
`/api/v1/bot-battle`	None	Rate-limited public paper telemetry.
`/api/v1/bot-battle/export.csv`	None	CSV export for spreadsheet ingestion.

Endpoints

POST/api/v1/registerAPI key

Create a free API key. Body: {"email":"[email protected]","app_name":"My Bot"}.

POST/api/v1/oracleAI consensus

Ask the AI oracle a crypto or market question and receive a weighted consensus plus individual votes.

GET/api/v1/predictionsmarkets

Active prediction markets, AI consensus, market context and deadline metadata.

GET/api/v1/leaderboard?asset=btcarena

Live arena strategy leaderboard for one asset, including PnL, trade counts and ranks.

GET/api/v1/bot-battlebot telemetry

Aggregates the current Bot Battle lanes: four Binance lanes and two Raydium LP lanes, with compact capital, PnL and status fields.

GET/api/v1/bot-battle/export.csv?venue=allCSV

Spreadsheet-friendly CSV. venue can be all, binance, or raydium.

GET/api/openapi-lite.jsonspec

Lightweight OpenAPI-style machine-readable description of the public API surface.

Examples

Read Bot Battle JSON

curl https://strategyarena.io/api/v1/bot-battle | jq '.summary'

Export Raydium lanes to CSV

curl "https://strategyarena.io/api/v1/bot-battle/export.csv?venue=raydium" \
  -o strategyarena_raydium_lanes.csv

Ask the oracle

curl -X POST https://strategyarena.io/api/v1/oracle \
  -H "X-API-Key: sa_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"Will BTC trend up over the next 24h?"}'

Bot Battle fields

Field	Meaning
`venue`	`binance` or `raydium`.
`name`	Stable lane identifier.
`mode`	`paper` or live/source-specific label.
`status`	Current state such as `waiting`, `in_market`, `in_lp`, or `harvesting`.
`capital`, `pnl_pct`, `pnl_usd`	Current paper-equity snapshot for the lane.
`positions_count`	Raydium LP position count when applicable.
`last_tick`	UTC timestamp of the latest lane update.