Get the lifecycle status of a swap
Returns a focused view of one swap's lifecycle for cheap UI polling: the settlement breakdown plus its cross-chain repayment jobs. Status is COMPLETE (settled and every repayment delivered), SETTLED_DST (settled, repayments still in flight), or UNKNOWN (not yet seen on this server).
Authorization
ApiKeyAuth In: header
Path Parameters
The swap's identifier, returned by /api/swap/authorize or /api/swap/quote.
Response Body
application/json
curl -X GET "https://example.com/api/swap/status/string"{ "swapId": "string", "status": "COMPLETE", "breakdown": { "swapId": "string", "chainId": 0, "poolId": "string", "settled": true, "totalCapital": "string", "settlementDelta0": "string", "settlementDelta1": "string" }, "repaymentJobs": [ { "jobId": "string", "obligationId": "string", "status": "string", "sourceLp": "string", "sourceChainId": 0, "destinationFiller": "string", "targetChainId": 0, "token": "string", "amount": "string", "bridgeKind": "string", "withdrawTxHash": "string", "bridgeTxHash": "string", "bridgeMessageId": "string", "observedDepositTxHash": "string", "lastError": "string", "updatedAt": "string" } ]}Preview one trade priced across venues on several chains
Read-only. Discovers every venue offering the pair on every allowed chain, splits the size across them by best marginal price, and reports the combined result against the best single source. Places no capital hold and mints no signature. Sources whose chain has no settlement driver to the destination are excluded, with the reason.
List supported tokens
Returns the tokens visible across the marketplace, with results cached. Filter with `chainId`, or with `chain` as a slug alias, where a slug that names no supported chain returns no tokens.