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 solver SolveResponse 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.

WELCOME

REIY PROTOCOL

RESOURCES

Fisherman API

Fisherman API

Open Fisherman API Docs

Download OpenAPI JSON

Current deployment

Endpoint groups

Winner selection summary

Integration path

Solver integration

Execute settlement

​Fisherman API

Open Fisherman API Docs

Download OpenAPI JSON

​Current deployment

​Endpoint groups

​Winner selection summary

​Integration path

Solver integration

Execute settlement

Fisherman API

Current deployment

Endpoint groups

Winner selection summary

Integration path