Get Swap Status

Endpoint

GET /bridge/swap/{swap_id}

Server: https://bridge.openfish.me

Auth: None

Tags: Bridge

Use this endpoint after POST /bridge/swap/execute to track whether FISH has been credited to the Openfish CLOB ledger.

Path Parameters

Name	Type	Description
`swap_id`	string	Swap ID returned by execute.

Response

200

{
  "swapId": "de8c8c12-8af7-4f4e-a41e-f97a6c3c9d19",
  "quoteId": "2e7cde57-466e-4e17-a7e5-3a0c2a09a142",
  "address": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
  "depositAddress": "0x23566f8b2E82aDfCf01846E54899d110e97AC053",
  "status": "CREDITED",
  "amountInWei": "1000000000000000",
  "minAmountOutBaseUnit": "2376500000000000000000",
  "fishReceivedBaseUnit": "2450000000000000000000",
  "fishCreditedBaseUnit": "2450000000000000000000",
  "swapTxHash": "0xabc123...",
  "sweepTxHash": "0xdef456...",
  "error": null,
  "createdAt": "2026-05-07T03:29:05Z",
  "updatedAt": "2026-05-07T03:29:42Z"
}

Usage

curl "https://bridge.openfish.me/bridge/swap/de8c8c12-8af7-4f4e-a41e-f97a6c3c9d19"

Status Values

Status	Meaning
`SUBMITTED`	Execute request accepted.
`SWAP_CONFIRMED`	BNB -> FISH swap transaction was confirmed.
`SWEEP_SUBMITTED`	FISH sweep from the deposit address was submitted.
`SWEPT`	FISH sweep was confirmed.
`CREDITED`	Openfish CLOB FISH balance was credited.
`FAILED`	Swap failed; inspect `error`.
`EXPIRED`	Quote or swap request expired.
`MANUAL_REVIEW`	Manual review is required before funds can be credited.

List Swap History

List recent swaps for a wallet:

GET /bridge/swaps?address=0xYourOpenfishWallet&limit=20

Example:

curl "https://bridge.openfish.me/bridge/swaps?address=0x56687bf447db6ffa42ffe2204a05edaa20f55839&limit=20"

Response:

[
  {
    "swapId": "de8c8c12-8af7-4f4e-a41e-f97a6c3c9d19",
    "quoteId": "2e7cde57-466e-4e17-a7e5-3a0c2a09a142",
    "address": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
    "depositAddress": "0x23566f8b2E82aDfCf01846E54899d110e97AC053",
    "status": "CREDITED",
    "amountInWei": "1000000000000000",
    "minAmountOutBaseUnit": "2376500000000000000000",
    "fishReceivedBaseUnit": "2450000000000000000000",
    "fishCreditedBaseUnit": "2450000000000000000000",
    "swapTxHash": "0xabc123...",
    "sweepTxHash": "0xdef456...",
    "error": null,
    "createdAt": "2026-05-07T03:29:05Z",
    "updatedAt": "2026-05-07T03:29:42Z"
  }
]

Client Handling

Poll until CREDITED, FAILED, or MANUAL_REVIEW.
After CREDITED, check GET /agent/account/state or openfish clob balance --asset-type collateral.
Do not assume a BNB transfer alone creates Openfish FISH balance.