> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reiy.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Fisherman API

> Canonical API reference for the Reiy Fisherman execution coordinator.

# Fisherman API

The canonical API reference for the Reiy execution coordinator is hosted by the live testnet Fisherman deployment:

<CardGroup cols={2}>
  <Card title="Open Fisherman API Docs" href="https://testnet-fisherman.reiy.finance/docs">
    Browse the Scalar API reference for the current testnet deployment.
  </Card>

  <Card title="Download OpenAPI JSON" href="https://testnet-fisherman.reiy.finance/openapi.json">
    Use the OpenAPI 3.1 spec for client generation, validation, or integration tests.
  </Card>
</CardGroup>

## 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.

<Note>
  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.
</Note>

## Integration path

<CardGroup cols={2}>
  <Card title="Solver integration" href="/reiy-protocol/integrate/solver-integration">
    Follow the implementation path for solver services.
  </Card>

  <Card title="Execute settlement" href="/reiy-protocol/tutorials/solvers/execute-settlement">
    Review the settlement flow after receiving a winning certificate.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.