Check swap status
get_swap_statusCheck a cross-chain swap's current state by its swap_id — pending, processing, success, failed, refunded, incomplete deposit or expired — and get deposit, payout and refund links to confirm whether funds arrived.
Instructions
Look up a swap made with create_swap by its swap_id and explain where it is: PENDING (no deposit seen yet), PROCESSING, SUCCESS, FAILED, REFUNDED, INCOMPLETE_DEPOSIT (less than required arrived) or EXPIRED (address closed, never send to it). swap_id is the protocol-prefixed id create_swap returned, such as near: or chainflip:--; pass it unchanged, prefix included. Returns amounts in normal units and the deposit, payout and refund transaction links. A malformed id is rejected before any request, an unknown one returns "No swap with that id", and a router outage returns an error to retry later. Use it when the user asks whether their swap arrived. Read-only and safe to repeat; poll every 30 seconds or more, not in a tight loop.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"swap_id": "<swap_id>"
},
"name": "get_swap_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| swap_id | Yes | swap_id exactly as returned by create_swap, e.g. "near:0xAbc..." or "chainflip:123-Btc-45". |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | No | Failure or refund reason from the route, if any. | |
| status | Yes | Current state. | |
| meaning | Yes | Plain-language explanation of the status. | |
| swap_id | Yes | The swap. | |
| protocol | No | Route used. | |
| refunded | No | Refunded amount, if any. | |
| amount_in | No | Expected deposit. | |
| amount_out | No | Actual payout, once known. | |
| expires_at | No | When the deposit address stops accepting funds. | |
| payout_txs | No | Payout transaction links or hashes. | |
| quoted_out | No | Output quoted at creation. | |
| refund_txs | No | Refund transaction links or hashes. | |
| deposit_txs | No | Deposit transaction links or hashes. | |
| explorer_url | No | Public tracking link. | |
| deposit_address | No | Where the deposit goes. |