# MultiHopper

MultiHopper is a protocol for scheduled, multi-hop token transfers on Solana. It exposes a REST API and on-chain smart contracts for building programmable payment pipelines: vesting schedules, payroll automation, escrow flows, and treasury distribution.

## How It Works

- Tokens are locked in a program-controlled vault
- Wrapper tokens (Token2022 with permanent delegate) flow through the route
- A permissionless keeper network executes hops and steps on-chain
- An orchestrator manages deployment and sequencing

## Core Concepts

- **Route** — the primary routing primitive; defines hops, recipients, and timing
- **Hop** — a single transfer step within a route
- **Keeper** — permissionless on-chain executor that advances route state
- **Timelock** — on-chain enforcement of scheduled execution windows

## REST API

Base URL: https://www.multihopper.com/api/v1

### Endpoints

- `POST /transfers/estimate` — Quote fees exactly as the chain will charge them (no side effects)
- `POST /transfers` — Create a transfer: one `recipientWallet`, or up to 20 `destinations`
- `POST /transfers/:id/prepare` — Get the unsigned transactions to sign with your wallet
- `POST /transfers/:id/confirm-broadcast` — Report signatures; the keeper takes over
- `GET  /transfers/:id` — Poll status, phase, progress, and per-destination payouts
- `GET  /transfers` — List and batch query transfers
- `POST /webhooks` — Register a webhook for transfer events
- `GET  /usage` — Volume and your revenue share (paid atomically on chain)

### Pricing

Fees come from the program's on-chain fee schedule: a percent fee plus a per-hop charge that ramps
with the transfer's USD value, which is read from the same Raydium pool the program uses. Integrators
receive 50% of every fee, split atomically on chain.
Details: https://dev-docs.multihopper.com/concepts/pricing

### Multi-destination

Pass `destinations: [{ wallet, amountRaw }]` instead of `recipientWallet` to pay up to 20 wallets from
one route. No destination appears in the route's hop list.
Details: https://dev-docs.multihopper.com/guides/multi-destination

### Authentication

API key via `x-api-key: <key>` or `Authorization: Bearer <key>` header.

### OpenAPI Spec

Full OpenAPI 3.1 spec: https://www.multihopper.com/openapi.json
Interactive docs: https://dev-docs.multihopper.com/api-reference/introduction

## MCP Server

An MCP server for documentation and API exploration is available at:
https://dev-docs.multihopper.com/mcp (SSE transport, no auth required)

Tools: `search_multi_hopper`, `query_docs_filesystem_multi_hopper`

## Developer Documentation

Full guides, quickstart, and agentic integration reference:
https://dev-docs.multihopper.com/