# Wagyu Docs

> Build Monero and Zcash swaps, bridges and agent tools on the Wagyu API. Base URL: https://api-beta.wagyu.xyz (public, no key needed to quote, create or track). MCP server: https://mcp.wagyu.xyz.

Every page is also served as Markdown at its URL plus `.md`; the links below point at those copies. Values such as minimums, fees, chains and limits are read from the live API when the site builds.

## Guides

- [Wagyu API documentation](https://docs.wagyu.xyz/index.md): Quote, create and track cross-chain swaps into and out of Monero (XMR) and Zcash (ZEC), bridge XMR and ZEC to Hyperliquid, and give AI agents a swap tool. Public API, no key needed to start.
- [Quickstart](https://docs.wagyu.xyz/getting-started.md): Quote, create and track a Wagyu swap in four HTTP calls, with real requests and responses from the live API.
- [API keys and integrator fees](https://docs.wagyu.xyz/authentication.md): Get a Wagyu integrator key in two minutes, earn your own fee on every order you send, read your reporting, and understand rate limits, order ownership and session credentials.
- [Supported chains and tokens](https://docs.wagyu.xyz/chains.md): Every chain the Wagyu API supports, with chain ids, which side of a swap each can be on, minimum deposits, confirmations and the exact token value to send for native coins.
- [Order lifecycle](https://docs.wagyu.xyz/order-lifecycle.md): Every Wagyu order status and customerState, which one to show, when the user must act, and how to read swap, bridge and session orders.
- [Deposits and refunds](https://docs.wagyu.xyz/deposits.md): What happens when a Wagyu deposit is short, over, late or under the minimum, how top-ups work, and how refund and replacement payout addresses are submitted.
- [Amounts and fees](https://docs.wagyu.xyz/money-and-settlement.md): How the Wagyu API represents money (atomic integer strings), how to convert amounts safely, what each route costs today, and which fields are settlement evidence.
- [Errors, limits and retries](https://docs.wagyu.xyz/actions-and-retries.md): The Wagyu API error envelope, every error code and what to do about it, rate limits and Retry-After, and a safe retry policy for reads, quotes and order creation.
- [Live updates over WebSockets](https://docs.wagyu.xyz/live-updates.md): Follow Wagyu orders in real time over WebSockets (one socket per order, or many orders on one socket), plus public feeds of recent swaps and bridges.
- [Native bridge (XMR1 and ZEC1)](https://docs.wagyu.xyz/native-bridge.md): Bridge Monero and Zcash to Hyperliquid as XMR1 and ZEC1 and back with the Wagyu API, with live fees, minimums, availability and request examples.
- [Public data and statistics](https://docs.wagyu.xyz/public-data.md): Public Wagyu API routes for protocol volume, median swap times per route, recent swaps and bridges, Monero nodes and points, all without authentication.
- [MCP server for AI agents](https://docs.wagyu.xyz/mcp.md): Connect Claude, Cursor or any MCP client to Wagyu's Model Context Protocol server to quote, create and track swaps as tools. No key needed.
- [Build with an AI agent](https://docs.wagyu.xyz/agent-handoff.md): How to hand a Wagyu integration to a coding agent such as Claude Code or Cursor, what it should read in which order, and the rules it must not break.
- [API reference](https://docs.wagyu.xyz/api-reference.md): Every route of the Wagyu HTTP API, generated from the live OpenAPI contract, with authentication, parameters, response fields and real captured examples.

## API reference

- [GET /v2/swaps/terms](https://docs.wagyu.xyz/api-reference/get-swap-terms.md): Get swap terms. Read the swap rules before creating an order: deposit window, minimum and confirmations per chain, partial deposits, default limits
- [GET /v2/swaps/assets](https://docs.wagyu.xyz/api-reference/get-swap-assets.md): List chains and featured tokens. List available swap chains and featured assets
- [GET /v2/swaps/assets/tokens](https://docs.wagyu.xyz/api-reference/get-swap-asset-tokens.md): Search tokens. Search or page available swap assets
- [POST /v2/swaps/quote](https://docs.wagyu.xyz/api-reference/quote-swap.md): Quote a swap. Quote an exact-input or exact-output swap
- [POST /v2/swaps](https://docs.wagyu.xyz/api-reference/create-swap-order.md): Create a swap order. Create a durable swap order (supply your own sessionId only with a valid integrator key)
- [GET /v2/swaps/{id}](https://docs.wagyu.xyz/api-reference/get-swap-order.md): Read a swap order. Read a swap order with an owner session or destination proof
- [GET /v2/swaps/{id}/fills](https://docs.wagyu.xyz/api-reference/get-swap-fills.md): List Hyperliquid fills. Page saved execution receipts with an owner session or destination proof
- [PUT /v2/swaps/{id}/coinflip](https://docs.wagyu.xyz/api-reference/resolve-coinflip.md): Answer a swap’s bonus flip. Submit a coinflip decision for an eligible order
- [GET /v2/bridges/terms](https://docs.wagyu.xyz/api-reference/get-bridge-terms.md): Get bridge terms. Read bridge fees and minimums
- [GET /v2/bridges/quote](https://docs.wagyu.xyz/api-reference/quote-bridge.md): Quote a bridge amount. Quote the net settlement for a bridge amount
- [POST /v2/bridges](https://docs.wagyu.xyz/api-reference/create-bridge-order.md): Create a bridge order. Create a native bridge order for one asset and direction (supply your own sessionId only with a valid integrator key)
- [GET /v2/bridges/{id}](https://docs.wagyu.xyz/api-reference/get-bridge-order.md): Read a bridge order. Read a bridge order with an owner session or destination proof
- [DELETE /v2/orders/{id}](https://docs.wagyu.xyz/api-reference/delete-order.md): Delete an order. Permanently remove a completed or refunded order
- [GET /v2/orders](https://docs.wagyu.xyz/api-reference/list-session-orders.md): List a session’s orders. List orders owned by a session
- [GET /v2/orders/{id}/review](https://docs.wagyu.xyz/api-reference/get-order-review.md): Read an order review. Read an order review with an owner session or destination proof
- [PUT /v2/orders/{id}/review](https://docs.wagyu.xyz/api-reference/submit-order-review.md): Review an order. Submit a completed-order review
- [PUT /v2/orders/{id}/refund-address](https://docs.wagyu.xyz/api-reference/submit-refund-address.md): Submit a refund address. Submit a refund address for an eligible order
- [POST /v2/orders/{id}/deposit-wait/close](https://docs.wagyu.xyz/api-reference/continue-on-arrived-deposit.md): Continue on a short deposit. Stop waiting for the rest of a short deposit and continue on what arrived
- [PUT /v2/orders/{id}/payout-address](https://docs.wagyu.xyz/api-reference/submit-payout-address.md): Submit a replacement payout address. Submit a replacement payout address when the order asks for one
- [GET /v2/integrator/me](https://docs.wagyu.xyz/api-reference/get-integrator.md): Read your integration. Read your integration profile, fee settings, activity, limits and usage.
- [GET /v2/integrator/orders](https://docs.wagyu.xyz/api-reference/list-integrator-orders.md): List attributed orders. List recent orders attributed to your integration and the status of your fee on each.
- [GET /v2/stats/daily](https://docs.wagyu.xyz/api-reference/get-protocol-stats.md): Get protocol statistics. Read protocol volume statistics
- [GET /v2/swaps/route-stats](https://docs.wagyu.xyz/api-reference/get-swap-route-stats.md): Get route execution times. Read 30-day measured execution medians by token and network
- [GET /v2/recent-swaps](https://docs.wagyu.xyz/api-reference/get-recent-swaps.md): List recent swaps. List recent completed swaps
- [GET /v2/bridges/recent](https://docs.wagyu.xyz/api-reference/get-recent-bridge-orders.md): List recent bridge orders. List recent completed bridge orders
- [GET /v2/nodes](https://docs.wagyu.xyz/api-reference/list-nodes.md): List Monero nodes. List recommended monerod endpoints for a self-custody wallet
- [GET /v2/points/{address}](https://docs.wagyu.xyz/api-reference/get-points.md): Get an address’s points. Read an address points balance
- [GET /v2/points/leaderboard](https://docs.wagyu.xyz/api-reference/get-points-leaderboard.md): Get the points leaderboard. List the points leaderboard
- [POST /v2/coinflips/{id}/bets](https://docs.wagyu.xyz/api-reference/place-coinflip-bet.md): Place a coinflip bet. Place one bet at an open coinflip table; answers with the table as it stands after the flip
- [POST /v2/coinflips/{id}/cashout](https://docs.wagyu.xyz/api-reference/cash-out-coinflip.md): Cash out a coinflip table. Close an open coinflip table and pay its balance to the destination
- [POST /v2/coinflips/{id}/presence](https://docs.wagyu.xyz/api-reference/coinflip-presence.md): Keep a coinflip table open. Tell an open table its player is present, so the idle window does not close it
- [POST /v2/coinflips/{id}/reopen](https://docs.wagyu.xyz/api-reference/reopen-coinflip.md): Reopen a coinflip table. Reopen a table the idle window closed while it still held a balance and before any cash-out
- [GET /v2/coinflips/recent](https://docs.wagyu.xyz/api-reference/get-recent-coinflip-rounds.md): List recent coinflip rounds. List recent played table rounds without owner or fairness data
- [GET /v2/coinflips/terms](https://docs.wagyu.xyz/api-reference/get-coinflip-terms.md): Get coinflip terms. Read which coinflip pool assets are stakeable right now, with their minimum, fee and odds
- [POST /v2/coinflips](https://docs.wagyu.xyz/api-reference/create-coinflip-order.md): Create a coinflip table. Create a coinflip-table order: stake one asset, flip after confirmation, a win pays the same asset (supply your own sessionId only with a valid integrator key)
- [GET /v2/coinflips/{id}](https://docs.wagyu.xyz/api-reference/get-coinflip-order.md): Read a coinflip table. Read a coinflip-table order with an owner session or destination proof

## Machine-readable contracts

- [OpenAPI 3.1 (HTTP)](https://docs.wagyu.xyz/openapi.json): same document as https://api-beta.wagyu.xyz/v2/docs
- [AsyncAPI 3.0 (WebSockets)](https://docs.wagyu.xyz/asyncapi.json): same document as https://api-beta.wagyu.xyz/v2/asyncapi
- [Everything on one page](https://docs.wagyu.xyz/llms-full.txt)

## Optional

- [Compliance Policy](https://docs.wagyu.xyz/compliance-policy.md): Wagyu's compliance policy: how it handles restriction, blacklisting and potential seizure of user assets, and the rule that assets are frozen only on a binding court order.
- [Wagyu Wallet — Privacy Policy](https://docs.wagyu.xyz/privacy-policy.md): Privacy policy of the Wagyu Wallet browser extension: what stays on your device, what is transmitted and to whom, and what Wagyu does not do.