Skip to main content
Tell Relay what your user wants to do. The API returns a quote and the steps to complete it, then lets you track the transaction through completion.

Platform Execution

  1. Quote: Your application requests an outcome. The API returns a route, expected output, fees, and the steps required to execute it.
  2. Authorize: The user signs the transactions or messages returned in the quote. Deposit methods and transaction targets depend on the route; follow the returned steps rather than substituting a fixed address.
  3. Fill: For a cross-chain order, a solver uses its own capital to complete the requested action on the destination chain. Same-chain swaps execute on the source chain without a cross-chain fill.
  4. Track: Your application monitors the request through completion or refund using the status API.

Protocol Settlement

For orders using the settlement protocol, users deposit into a Relay Depository Contract. Solvers fill on the destination chain, then submit attestations that credit their balances on the Hub. Withdrawal proofs authorize payment from the Depository. The protocol separates deposits, fills, verification, and withdrawals across distinct components. Its security model explains the Oracle, Allocator, and Security Council trust assumptions. Protocol support does not mean every platform route uses that settlement flow. API endpoint versions, including /requests/v3, version the API—not the settlement protocol used by an order.

The Relay Stack

Relay API

Request quotes, execute transactions, track status, and retrieve supported network data.

RelayKit

Use the SDK, React hooks, and UI components to add Relay to your application.

Relay Protocol

Explore settlement contracts, fill verification, and the protocol’s security model.

Relay App

Explore supported routes and transact through the same infrastructure available to integrators.