Swap Status

GET /swap/status/{swapId} | Auth: Required

Retrieve the current status of a swap by its ID. Use this endpoint to poll for transaction completion after executing a swap via POST /swap/execute.

Request

Path Parameters

Field	Type	Required	Description
swapId	integer	Yes	The swap ID returned from POST /swap/execute

Example Request

GET /swap/status/4821

Response

Field	Type	Description
success	boolean	Whether the request succeeded
swap_id	integer	The swap identifier
status	string	Current status: "submitted", "pending", "completed", or "failed"
tx_hash	string \	null	Transaction hash, or null if not yet broadcast
from_token	string	Source token symbol (e.g., "ETH")
to_token	string	Destination token symbol (e.g., "USDC")

Status Lifecycle

submitted → pending → completed
                    → failed

• submitted -- The transaction has been signed and sent to the network.
• pending -- The transaction is waiting for on-chain confirmation.
• completed -- The swap executed successfully and is confirmed on-chain.
• failed -- The transaction reverted or could not be confirmed.

Example Response

{
  "hl-key">"success": true,
  "hl-key">"swap_id": 4821,
  "hl-key">"status": "completed",
  "hl-key">"tx_hash": "0x8a3c...f29e",
  "hl-key">"from_token": "ETH",
  "hl-key">"to_token": "USDC"
}

Errors

Status	Error	Cause
401	"Unauthorized"	Missing or invalid API key
404	"Swap not found"	No swap exists with the given ID, or it belongs to a different agent

Code Examples

curl

-kw">curl https://api.suwappu.bot/v1/agent/swap/status/4821 \
  -H -str">"Authorization: Bearer suwappu_sk_your_api_key"

Python

import requests

response = requests.get(
    class="hl-str">"https:class="hl-commentclass="hl-str">">//api.suwappu.bot/v1/agent/swap/status/4821",
    headers={class="hl-str">"Authorization": class="hl-str">"Bearer suwappu_sk_your_api_key"},
)

data = response.json()
if data[class="hl-str">"success"]:
    print(fclass="hl-str">"Swap {data[class="hl-str">'swap_id']}: {data[class="hl-str">'status']}")
    print(fclass="hl-str">"{data[class="hl-str">'from_token']} → {data[class="hl-str">'to_token']}, tx: {data[class="hl-str">'tx_hash']}")

TypeScript

const response = await fetch(
  class="hl-str">"https:class="hl-commentclass="hl-str">">//api.suwappu.bot/v1/agent/swap/status/4821",
  {
    headers: {
      Authorization: class="hl-str">"Bearer suwappu_sk_your_api_key",
    },
  }
);

const data = await response.json();
if (data.success) {
  console.log(Swap ${data.swap_id}: ${data.status});
  console.log(${data.from_token} → ${data.to_token}, tx: ${data.tx_hash});
}