Fisherman API
The canonical API reference for the Reiy execution coordinator is hosted by the live testnet Fisherman deployment:Open Fisherman API Docs
Browse the Scalar API reference for the current testnet deployment.
Download OpenAPI JSON
Use the OpenAPI 3.1 spec for client generation, validation, or integration tests.
Current deployment
| Field | Value |
|---|---|
| API docs | https://testnet-fisherman.reiy.finance/docs |
| OpenAPI spec | https://testnet-fisherman.reiy.finance/openapi.json |
| OpenAPI version | 3.1.0 |
| Fisherman API version | 0.1.0 |
| Server | https://testnet-fisherman.reiy.finance |
Endpoint groups
The testnet Fisherman API currently exposes these groups:| Group | Endpoints |
|---|---|
| System | GET /health, GET /metrics, GET /events/stream |
| Orderbook | GET /orderbook |
| Auctions | GET /auctions/active, GET /auctions/{id}, POST /solve, POST /reveal, POST /admin/retry/{auctionId} |
| Certificates | GET /certificates/{id}, POST /settle |
| Solvers | POST /quote, POST /notify |
| Indexer | POST /indexer/sync, GET /indexer/health, GET /indexer/intents, GET /indexer/settlements, GET /indexer/state/{kind}, GET /indexer/events/stream |
Winner selection summary
Fisherman currently validates solverSolveResponse payloads and selects the highest valid score. If scores tie, the winner is chosen deterministically by solver endpoint id. After ranking, Fisherman signs a certificate and asks the winning solver to settle it on-chain.
Treat the hosted OpenAPI document as the source of truth for request and response schemas. This page intentionally links to Fisherman instead of duplicating schema details that can drift.
Integration path
Solver integration
Follow the implementation path for solver services.
Execute settlement
Review the settlement flow after receiving a winning certificate.