# 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_summary` on the [core MCP server](https://swap.thorchain.org/developers/mcp) — pool balances and compact network metrics. Page pools with `limit` and `offset`. For chain halt state use core `get_inbound_addresses` and `get_mimir`; get their schemas from `tools/list`.

## 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](https://swap.thorchain.org/openapi.json) first.

## Related

- [REST API reference](https://swap.thorchain.org/developers/api)
- [MCP server](https://swap.thorchain.org/developers/mcp)
