# Opono simulation API

Simulate football matches before kick-off.

Base URL: https://api.opono.com/v1; alternative: https://opono.com/api/v1.

Authentication: Authorization: Bearer sk_live_… or sk_test_…; create a key at https://opono.com/developers.

Plus: £20/month for 100,000 simulated matches · 100 credits each billing month. Pro: £200/month for 2,500,000 simulated matches · 2,500 credits each billing month. Available to customers in the United Kingdom only. The price shown is the total you pay.

1 credit = 1,000 simulated matches; default 1,000 simulated matches · 1 credit, cached or fresh.

Credits are reserved at request, settled on delivery, and released on failure.

Test output is synthetic and costs zero credits; Free has no API access.

## Launch endpoints

- POST /v1/simulations
- GET /v1/simulations/jobs/{job_id}
- POST /v1/simulations/batch
- GET /v1/simulations/batches/{batch_id}
- GET /v1/fixtures
- GET /v1/fixtures/{fixture_id}/squads
- GET /v1/fixtures/{fixture_id}/expected-lineup
- POST /v1/simulations/quote
- GET /v1/credits
- GET /v1/usage

## Documentation

- [Overview](https://opono.com/docs)
- [Quickstart](https://opono.com/docs/quickstarts/rest)
- [Authentication](https://opono.com/docs/authentication)
- [Simulations](https://opono.com/docs/simulations)
- [Choosing lineups](https://opono.com/docs/choosing-lineups)
- [Credits and billing](https://opono.com/docs/credits-and-usage)
- [Rate limits](https://opono.com/docs/limits)
- [Errors](https://opono.com/docs/errors)
- [Fixtures](https://opono.com/docs/fixtures)
- [Squads](https://opono.com/docs/reference/squads)
- [Opono Expected Lineup](https://opono.com/docs/reference/expected-lineup)
- [Simulations](https://opono.com/docs/reference/simulations)
- [Jobs](https://opono.com/docs/jobs)
- [Errors object](https://opono.com/docs/reference/errors)
- [Changelog](https://opono.com/docs/changelog)
- [Support](https://opono.com/docs/support)
- [Plans](https://opono.com/pricing)
- [OpenAPI](https://opono.com/docs/openapi.json)

[Full documentation](https://opono.com/llms-full.txt)