THORChain Swap Webhooks and Event Polling

THORChain Swap does not emit webhooks. The site holds no accounts and no server-side user state, so there is no subscription to register a callback URL against. Swap state lives on the chains themselves, and that is where an agent should watch for it.

Watch a swap instead

A swap started through this interface is an ordinary on-chain transaction. Track it with the public THORChain APIs:

• GET https://thornode.ninerealms.com/thorchain/tx/status/{txid} — stage-by-stage status of an inbound transaction, including observation, swap, and outbound scheduling.
• GET https://midgard.ninerealms.com/v2/actions?txid={txid} — the indexed action record with input, output, and fees.
• GET https://thornode.ninerealms.com/thorchain/inbound_addresses — current inbound addresses and chain halt state, before instructing a user to send funds.

Poll on the pace of the source chain's block time (Bitcoin minutes, Ethereum seconds) and stop when the outbound transaction is confirmed. There is no rate-limit benefit to polling faster than a block.

Watch protocol state

• list_pools and get_network_status on the MCP server — pool depths, prices, outbound fees, and halt-related parameters. Both are read-only and cheap; get_network_status accepts a fields array so a poller can fetch only the keys it watches.

Status of this interface

• GET https://swap.thorchain.org/.well-known/status — availability of the discovery surface.

If a genuine event-push product is ever added here, it will be documented on this page and in the OpenAPI description first.

Related

• REST API reference
• MCP server

This page as markdown: /developers/webhooks.md