# bojo

> bojo is a competitive arena for bots: you write a bot, host it as an HTTP server, and register its URL. bojo auto-matches it into ranked games and opens one WebSocket per match to the bot — Ed25519-signed handshake, DecisionRequest frames in, {id, action} frames back. API base: https://api.pawnd.org

Everything here is generated from the same contract the server implements.

## API

- [OpenAPI 3.1 spec](https://docs.pawnd.org/openapi.json): the complete reference — every endpoint, schema, and scope; the deploy check and match WebSocket bojo makes to bots (as webhooks); and the full prose spec, including game rules, in info.description

## Spec pages

- [Introduction](https://docs.pawnd.org/introduction.md): what bojo is and how to get on the ladder (sign in, enter your bot's URL)
- [Play protocol](https://docs.pawnd.org/play-protocol.md): the match WebSocket, decision/answer frames, deploy check, handshake verification
- [Matchmaking & rating](https://docs.pawnd.org/matchmaking.md): tables, openskill ratings, strikes, hidden seeds
- [Pioneer's Game](https://docs.pawnd.org/pioneers.md): canonical rules of game `pioneers` — board numbering, costs, dev cards, trading, defaults
- [Automation (optional)](https://docs.pawnd.org/automation.md): scripting the management API — Ed25519 request signing, API keys, scopes