{"openapi":"3.1.0","info":{"title":"Pheasant Network API","version":"1.0.0","description":"API for automatically selected ERC-7683/CCTP transfers and LI.FI-backed swap quote/build/status."},"servers":[{"url":"https://api.pheasant.network","description":"prod API"}],"paths":{"/v1/capabilities":{"get":{"operationId":"getCapabilities","summary":"Get bridge capabilities","responses":{"200":{"description":"Capabilities response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilitiesResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/chains":{"get":{"operationId":"getChains","summary":"Get supported chains","responses":{"200":{"description":"Supported chains response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainsResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/tokens":{"get":{"operationId":"getTokens","summary":"Get supported tokens","parameters":[{"name":"chainId","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ChainId"}}],"responses":{"200":{"description":"Supported tokens response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokensResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/contracts":{"get":{"operationId":"getContracts","summary":"Get deployed contracts","parameters":[{"name":"chainId","in":"query","required":false,"schema":{"$ref":"#/components/schemas/ChainId"}}],"responses":{"200":{"description":"Contracts response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractsResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/quote":{"post":{"operationId":"createQuote","summary":"Create an ERC-7683 or CCTP transfer quote","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteRequest"}}}},"responses":{"200":{"description":"Quote response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/orders/build":{"post":{"operationId":"buildOrderTransaction","summary":"Build an unsigned transaction request for an ERC-7683 or CCTP transfer","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderBuildRequest"}}}},"responses":{"200":{"description":"Order build response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderBuildResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/orders/{orderId}":{"get":{"operationId":"getOrderStatus","summary":"Get order status by orderId","parameters":[{"name":"orderId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/OrderId"}}],"responses":{"200":{"description":"Order status response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderStatusResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Order not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/transactions/{txHash}":{"get":{"operationId":"getTransactionStatus","summary":"Get ERC-7683 or CCTP transfer status by transaction hash","parameters":[{"name":"txHash","in":"path","required":true,"schema":{"$ref":"#/components/schemas/TxHash"}}],"responses":{"200":{"description":"Transaction status response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionStatusResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Transaction not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/users/{address}/orders":{"get":{"operationId":"getUserOrders","summary":"Get latest ERC-7683 and CCTP transfers by user address","parameters":[{"name":"address","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Address"}},{"name":"limit","in":"query","required":false,"schema":{"$ref":"#/components/schemas/UserOrderLimit"}}],"responses":{"200":{"description":"User orders response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserOrdersResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/swap/quote":{"post":{"operationId":"createSwapQuote","summary":"Create a LI.FI swap quote","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapQuoteRequest"}}}},"responses":{"200":{"description":"Swap quote response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapQuoteResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/swap/orders/build":{"post":{"operationId":"buildSwapTransaction","summary":"Build an unsigned transaction for executing a swap through PheasantNetworkSwapProxy","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapBuildRequest"}}}},"responses":{"200":{"description":"Swap build response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapBuildResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/swap/transactions/{txHash}":{"get":{"operationId":"getSwapTransactionStatus","summary":"Get swap transaction status by txHash","parameters":[{"name":"txHash","in":"path","required":true,"schema":{"$ref":"#/components/schemas/TxHash"}}],"responses":{"200":{"description":"Swap transaction status response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapTransactionStatusResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/swap/users/{address}/orders":{"get":{"operationId":"getSwapUserOrders","summary":"Get latest swap orders by user address","parameters":[{"name":"address","in":"path","required":true,"schema":{"$ref":"#/components/schemas/Address"}},{"name":"limit","in":"query","required":false,"schema":{"$ref":"#/components/schemas/UserOrderLimit"}}],"responses":{"200":{"description":"Swap user orders response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapUserOrdersResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Unprocessable request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"ChainId":{"type":"integer","minimum":1},"Address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"NativeTokenPlaceholderAddress":{"type":"string","const":"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE","description":"ERC-7528 standard address placeholder for native assets in ERC-20 token contexts."},"Amount":{"type":"string","pattern":"^[0-9]+$"},"TxHash":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"OrderId":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"Timestamp":{"type":"string","format":"date-time"},"NullableTimestamp":{"oneOf":[{"$ref":"#/components/schemas/Timestamp"},{"type":"null"}]},"UserOrderLimit":{"type":"integer","minimum":1,"maximum":50,"default":10},"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNSUPPORTED_CHAIN","UNSUPPORTED_TOKEN","UNSUPPORTED_ROUTE","INSUFFICIENT_LIQUIDITY","AMOUNT_TOO_LOW","AMOUNT_TOO_HIGH","QUOTE_EXPIRED","QUOTE_NOT_FOUND","ORDER_BUILD_FAILED","INVALID_RECIPIENT","INVALID_SENDER","ALLOWANCE_CHECK_FAILED","RELAYER_UNAVAILABLE","ROUTE_PAUSED","SERVICE_DEGRADED","STATUS_NOT_FOUND","INTERNAL_ERROR"]},"message":{"type":"string"},"details":{"type":["object","null"]},"retryable":{"type":"boolean"}}}}},"CapabilitiesResponse":{"type":"object","required":["service","standards","features","security","status"],"properties":{"service":{"type":"object"},"standards":{"type":"object"},"features":{"type":"object"},"security":{"type":"object"},"status":{"type":"object"}}},"NativeCurrency":{"type":"object","required":["symbol","decimals"],"properties":{"symbol":{"type":"string"},"decimals":{"type":"integer"}}},"Chain":{"type":"object","required":["chainId","namespace","name","shortName","role","nativeCurrency","blockExplorerUrl","publicRpcUrl","status"],"properties":{"chainId":{"$ref":"#/components/schemas/ChainId"},"namespace":{"type":"string","enum":["eip155"]},"name":{"type":"string"},"shortName":{"type":"string"},"role":{"type":"array","items":{"type":"string","enum":["origin","destination"]}},"nativeCurrency":{"$ref":"#/components/schemas/NativeCurrency"},"blockExplorerUrl":{"type":["string","null"]},"publicRpcUrl":{"type":"null"},"status":{"type":"string","enum":["active","paused","deprecated","unsupported"]},"statusReason":{"type":["string","null"]}}},"ChainsResponse":{"type":"object","required":["chains"],"properties":{"chains":{"type":"array","items":{"$ref":"#/components/schemas/Chain"}}}},"Token":{"type":"object","required":["chainId","address","symbol","name","decimals","logoUrl","isNativePlaceholder","supportedAsInput","supportedAsOutput","status","statusReason"],"properties":{"chainId":{"$ref":"#/components/schemas/ChainId"},"address":{"$ref":"#/components/schemas/Address"},"isNativePlaceholder":{"type":"boolean","description":"True when address is the ERC-7528 native asset placeholder."},"symbol":{"type":"string"},"name":{"type":"string"},"decimals":{"type":"integer"},"logoUrl":{"type":["string","null"]},"supportedAsInput":{"type":"boolean"},"supportedAsOutput":{"type":"boolean"},"status":{"type":"string","enum":["active","paused","deprecated","unsupported"]},"statusReason":{"type":["string","null"]}}},"TokensResponse":{"type":"object","required":["tokens"],"properties":{"tokens":{"type":"array","items":{"$ref":"#/components/schemas/Token"}}}},"Contract":{"type":"object","required":["chainId","name","role","address","standard","verified","explorerUrl","status","statusReason"],"properties":{"chainId":{"$ref":"#/components/schemas/ChainId"},"name":{"type":"string"},"role":{"type":"string","enum":["originSettler","destinationSettler","cctpBurn","resolver","router","feeCollector"]},"address":{"$ref":"#/components/schemas/Address"},"standard":{"type":"string"},"verified":{"type":["boolean","null"]},"explorerUrl":{"type":["string","null"]},"status":{"type":"string","enum":["active","paused","deprecated","unsupported"]},"statusReason":{"type":["string","null"]}}},"ContractsResponse":{"type":"object","required":["contracts"],"properties":{"contracts":{"type":"array","items":{"$ref":"#/components/schemas/Contract"}}}},"QuoteRequest":{"type":"object","required":["originChainId","destinationChainId","amountIn","recipient"],"properties":{"originChainId":{"$ref":"#/components/schemas/ChainId"},"destinationChainId":{"$ref":"#/components/schemas/ChainId"},"inputToken":{"allOf":[{"$ref":"#/components/schemas/Address"}],"default":"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE","description":"Optional. Defaults to the ERC-7528 native token placeholder address when omitted. Native/ERC20 mixed routes are not supported."},"outputToken":{"allOf":[{"$ref":"#/components/schemas/Address"}],"default":"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE","description":"Optional. Defaults to the ERC-7528 native token placeholder address when omitted. Native/ERC20 mixed routes are not supported."},"amountIn":{"$ref":"#/components/schemas/Amount"},"recipient":{"$ref":"#/components/schemas/Address"}}},"FeeBreakdown":{"type":"object","required":["protocolFee","relayerFee","totalFee","feeToken"],"properties":{"protocolFee":{"$ref":"#/components/schemas/Amount"},"relayerFee":{"$ref":"#/components/schemas/Amount"},"totalFee":{"$ref":"#/components/schemas/Amount"},"feeToken":{"$ref":"#/components/schemas/Address"}}},"BridgeRouteInfo":{"type":"object","required":["type","originSettler","destinationSettler","orderDataType","burnContract","destinationDomain"],"properties":{"type":{"type":"string","const":"erc7683"},"originSettler":{"$ref":"#/components/schemas/Address"},"destinationSettler":{"$ref":"#/components/schemas/Address"},"orderDataType":{"type":"string"},"burnContract":{"type":"null"},"destinationDomain":{"type":"null"}}},"CctpRouteInfo":{"type":"object","required":["type","originSettler","destinationSettler","orderDataType","burnContract","destinationDomain"],"properties":{"type":{"type":"string","const":"cctp"},"originSettler":{"type":"null"},"destinationSettler":{"type":"null"},"orderDataType":{"type":"null"},"burnContract":{"$ref":"#/components/schemas/Address"},"destinationDomain":{"type":"integer","minimum":0}}},"RouteInfo":{"oneOf":[{"$ref":"#/components/schemas/BridgeRouteInfo"},{"$ref":"#/components/schemas/CctpRouteInfo"}],"discriminator":{"propertyName":"type","mapping":{"erc7683":"#/components/schemas/BridgeRouteInfo","cctp":"#/components/schemas/CctpRouteInfo"}}},"RouteConfig":{"type":"object","required":["routeId","originChainId","destinationChainId","inputToken","outputToken","tokenTypeIndex","originSettler","destinationSettler","orderDataType","minAmount","maxAmount","fees","estimatedFillTimeSeconds","liquidityAvailable","status","pauseReason"],"properties":{"routeId":{"type":"string"},"originChainId":{"$ref":"#/components/schemas/ChainId"},"destinationChainId":{"$ref":"#/components/schemas/ChainId"},"inputToken":{"$ref":"#/components/schemas/Address"},"outputToken":{"$ref":"#/components/schemas/Address"},"tokenTypeIndex":{"type":"integer"},"originSettler":{"$ref":"#/components/schemas/Address"},"destinationSettler":{"$ref":"#/components/schemas/Address"},"orderDataType":{"type":"string"},"minAmount":{"$ref":"#/components/schemas/Amount"},"maxAmount":{"oneOf":[{"$ref":"#/components/schemas/Amount"},{"type":"null"}]},"fees":{"type":"object","required":["feeRatioBps","minFee","maxFee","feeToken"],"properties":{"feeRatioBps":{"type":"integer"},"minFee":{"oneOf":[{"$ref":"#/components/schemas/Amount"},{"type":"null"}]},"maxFee":{"oneOf":[{"$ref":"#/components/schemas/Amount"},{"type":"null"}]},"feeToken":{"$ref":"#/components/schemas/Address"}}},"estimatedFillTimeSeconds":{"type":"integer"},"liquidityAvailable":{"type":"boolean"},"status":{"type":"string","enum":["active","paused","deprecated","unsupported","maintenance","liquidity_unavailable"]},"pauseReason":{"type":["string","null"]}}},"QuoteResponse":{"type":"object","required":["quoteId","originChainId","destinationChainId","inputToken","outputToken","amountIn","amountOut","fees","route","estimatedFillTimeSeconds","expiresAt","warnings"],"properties":{"quoteId":{"type":"string"},"originChainId":{"$ref":"#/components/schemas/ChainId"},"destinationChainId":{"$ref":"#/components/schemas/ChainId"},"inputToken":{"$ref":"#/components/schemas/Address"},"outputToken":{"$ref":"#/components/schemas/Address"},"amountIn":{"$ref":"#/components/schemas/Amount"},"amountOut":{"$ref":"#/components/schemas/Amount"},"fees":{"$ref":"#/components/schemas/FeeBreakdown"},"route":{"$ref":"#/components/schemas/RouteInfo"},"estimatedFillTimeSeconds":{"type":"integer"},"expiresAt":{"$ref":"#/components/schemas/Timestamp"},"warnings":{"type":"array","items":{"type":"object"}}}},"OrderBuildRequest":{"type":"object","required":["originChainId","destinationChainId","amountIn","minAmountOut","sender","recipient"],"properties":{"quoteId":{"type":"string","description":"Optional client-side quote identifier. The API does not persist quotes and does not resolve quoteId-only build requests."},"originChainId":{"$ref":"#/components/schemas/ChainId"},"destinationChainId":{"$ref":"#/components/schemas/ChainId"},"inputToken":{"allOf":[{"$ref":"#/components/schemas/Address"}],"default":"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE","description":"Optional. Defaults to the ERC-7528 native token placeholder address when omitted. Native/ERC20 mixed routes are not supported."},"outputToken":{"allOf":[{"$ref":"#/components/schemas/Address"}],"default":"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE","description":"Optional. Defaults to the ERC-7528 native token placeholder address when omitted. Native/ERC20 mixed routes are not supported."},"amountIn":{"$ref":"#/components/schemas/Amount"},"minAmountOut":{"$ref":"#/components/schemas/Amount"},"sender":{"$ref":"#/components/schemas/Address"},"recipient":{"$ref":"#/components/schemas/Address"},"fillDeadline":{"type":"integer"},"salt":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}}},"UnsignedTransactionRequest":{"type":"object","required":["chainId","to","from","value","data","gasLimit"],"properties":{"chainId":{"$ref":"#/components/schemas/ChainId"},"to":{"$ref":"#/components/schemas/Address"},"from":{"$ref":"#/components/schemas/Address"},"value":{"$ref":"#/components/schemas/Amount"},"data":{"type":"string","pattern":"^0x[a-fA-F0-9]*$"},"gasLimit":{"type":["string","null"]}}},"Approval":{"type":"object","required":["required","token","spender","amount","currentAllowance","transaction"],"properties":{"required":{"type":"boolean"},"token":{"$ref":"#/components/schemas/Address"},"spender":{"$ref":"#/components/schemas/Address"},"amount":{"$ref":"#/components/schemas/Amount"},"currentAllowance":{"$ref":"#/components/schemas/Amount"},"transaction":{"oneOf":[{"$ref":"#/components/schemas/UnsignedTransactionRequest"},{"type":"null"}]}}},"ResolvedOrder":{"type":"object","required":["originChainId","destinationChainId","originSettler","destinationSettler","sender","recipient","inputToken","outputToken","amountIn","minAmountOut","deadline"],"properties":{"originChainId":{"$ref":"#/components/schemas/ChainId"},"destinationChainId":{"$ref":"#/components/schemas/ChainId"},"originSettler":{"$ref":"#/components/schemas/Address"},"destinationSettler":{"$ref":"#/components/schemas/Address"},"sender":{"$ref":"#/components/schemas/Address"},"recipient":{"$ref":"#/components/schemas/Address"},"inputToken":{"$ref":"#/components/schemas/Address"},"outputToken":{"$ref":"#/components/schemas/Address"},"amountIn":{"$ref":"#/components/schemas/Amount"},"minAmountOut":{"$ref":"#/components/schemas/Amount"},"deadline":{"type":"integer"}}},"ResolvedCctpTransfer":{"type":"object","required":["originChainId","destinationChainId","burnContract","destinationDomain","sender","recipient","inputToken","outputToken","amountIn","amountOut","minAmountOut"],"properties":{"originChainId":{"$ref":"#/components/schemas/ChainId"},"destinationChainId":{"$ref":"#/components/schemas/ChainId"},"burnContract":{"$ref":"#/components/schemas/Address"},"destinationDomain":{"type":"integer","minimum":0},"sender":{"$ref":"#/components/schemas/Address"},"recipient":{"$ref":"#/components/schemas/Address"},"inputToken":{"$ref":"#/components/schemas/Address"},"outputToken":{"$ref":"#/components/schemas/Address"},"amountIn":{"$ref":"#/components/schemas/Amount"},"amountOut":{"$ref":"#/components/schemas/Amount"},"minAmountOut":{"$ref":"#/components/schemas/Amount"}}},"BridgeOrderBuildResponse":{"type":"object","required":["executionType","orderIdPreview","orderDataType","orderData","resolvedOrder","approval","transaction","expiresAt","notes"],"properties":{"executionType":{"type":"string","const":"erc7683"},"orderIdPreview":{"$ref":"#/components/schemas/OrderId"},"orderDataType":{"type":"string"},"orderData":{"type":"string","pattern":"^0x[a-fA-F0-9]*$"},"resolvedOrder":{"$ref":"#/components/schemas/ResolvedOrder"},"approval":{"$ref":"#/components/schemas/Approval"},"transaction":{"$ref":"#/components/schemas/UnsignedTransactionRequest"},"expiresAt":{"$ref":"#/components/schemas/Timestamp"},"notes":{"type":"array","items":{"type":"string"}}}},"CctpOrderBuildResponse":{"type":"object","required":["executionType","resolvedTransfer","approval","transaction","expiresAt","notes"],"properties":{"executionType":{"type":"string","const":"cctp"},"resolvedTransfer":{"$ref":"#/components/schemas/ResolvedCctpTransfer"},"approval":{"$ref":"#/components/schemas/Approval"},"transaction":{"$ref":"#/components/schemas/UnsignedTransactionRequest"},"expiresAt":{"$ref":"#/components/schemas/Timestamp"},"notes":{"type":"array","items":{"type":"string"}}}},"OrderBuildResponse":{"oneOf":[{"$ref":"#/components/schemas/BridgeOrderBuildResponse"},{"$ref":"#/components/schemas/CctpOrderBuildResponse"}],"discriminator":{"propertyName":"executionType","mapping":{"erc7683":"#/components/schemas/BridgeOrderBuildResponse","cctp":"#/components/schemas/CctpOrderBuildResponse"}}},"OrderStatusResponse":{"type":"object","required":["executionType","orderId","status","updatedAt"],"properties":{"executionType":{"type":"string","const":"erc7683"},"orderId":{"$ref":"#/components/schemas/OrderId"},"status":{"type":"string","enum":["opened","filled","settled","on_hold","expired","rejected","failed"]},"origin":{"type":["object","null"]},"destination":{"type":["object","null"]},"sender":{"$ref":"#/components/schemas/Address"},"recipient":{"$ref":"#/components/schemas/Address"},"input":{"type":"object"},"output":{"type":"object"},"timestamps":{"type":"object"},"updatedAt":{"$ref":"#/components/schemas/Timestamp"},"db":{"type":"object"}}},"CctpTransferStatusResponse":{"type":"object","required":["executionType","orderId","status","origin","destination","sender","recipient","input","output","timestamps","updatedAt","db"],"properties":{"executionType":{"type":"string","const":"cctp"},"orderId":{"type":"null"},"status":{"type":"string","enum":["opened","settled"]},"origin":{"type":"object"},"destination":{"type":"object"},"sender":{"$ref":"#/components/schemas/Address"},"recipient":{"$ref":"#/components/schemas/Address"},"input":{"type":"object"},"output":{"type":"object"},"timestamps":{"type":"object"},"updatedAt":{"$ref":"#/components/schemas/Timestamp"},"db":{"type":"object"}}},"TransactionStatusResponse":{"type":"object","required":["txHash","chainId","recognized","role","orderId","orderStatus","orderUrl"],"properties":{"txHash":{"$ref":"#/components/schemas/TxHash"},"chainId":{"oneOf":[{"$ref":"#/components/schemas/ChainId"},{"type":"null"}]},"recognized":{"type":"boolean"},"role":{"type":["string","null"],"enum":["origin_open","cctp_burn",null]},"orderId":{"oneOf":[{"$ref":"#/components/schemas/OrderId"},{"type":"null"}]},"orderStatus":{"type":["string","null"]},"orderUrl":{"type":["string","null"]},"executionType":{"type":["string","null"],"enum":["erc7683","cctp",null]},"status":{"type":["string","null"]},"origin":{"type":["object","null"]},"destination":{"type":["object","null"]},"sender":{"oneOf":[{"$ref":"#/components/schemas/Address"},{"type":"null"}]},"recipient":{"oneOf":[{"$ref":"#/components/schemas/Address"},{"type":"null"}]},"input":{"type":["object","null"]},"output":{"type":["object","null"]},"timestamps":{"type":["object","null"]},"updatedAt":{"oneOf":[{"$ref":"#/components/schemas/Timestamp"},{"type":"null"}]}}},"UserOrdersResponse":{"type":"object","required":["address","orders","count","limit"],"properties":{"address":{"$ref":"#/components/schemas/Address"},"orders":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/OrderStatusResponse"},{"$ref":"#/components/schemas/CctpTransferStatusResponse"}],"discriminator":{"propertyName":"executionType","mapping":{"erc7683":"#/components/schemas/OrderStatusResponse","cctp":"#/components/schemas/CctpTransferStatusResponse"}}}},"count":{"type":"integer"},"limit":{"$ref":"#/components/schemas/UserOrderLimit"}}},"SwapQuoteRequest":{"type":"object","required":["fromChainId","toChainId","fromTokenAddress","toTokenAddress","fromAmount","fromAddress","toAddress"],"properties":{"fromChainId":{"oneOf":[{"$ref":"#/components/schemas/ChainId"},{"type":"string"}]},"toChainId":{"oneOf":[{"$ref":"#/components/schemas/ChainId"},{"type":"string"}]},"fromTokenAddress":{"$ref":"#/components/schemas/Address"},"toTokenAddress":{"$ref":"#/components/schemas/Address"},"fromAmount":{"$ref":"#/components/schemas/Amount"},"fromAddress":{"$ref":"#/components/schemas/Address"},"toAddress":{"$ref":"#/components/schemas/Address"}}},"SwapToken":{"type":"object","required":["address","symbol","name","decimals"],"properties":{"address":{"$ref":"#/components/schemas/Address"},"symbol":{"type":"string"},"name":{"type":"string"},"decimals":{"type":"integer"},"logoUri":{"type":["string","null"]},"priceUSD":{"type":["string","null"]},"isNative":{"type":"boolean"}}},"SwapFeeCost":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"percentage":{"type":"string"},"token":{"$ref":"#/components/schemas/SwapToken"},"amount":{"type":"string"},"amountUSD":{"type":"string"},"included":{"type":"boolean"}}},"SwapGasCost":{"type":"object","properties":{"type":{"type":"string"},"amount":{"type":"string"},"amountUSD":{"type":"string"},"token":{"$ref":"#/components/schemas/SwapToken"},"gasLimit":{"type":"string"}}},"SwapQuoteResponse":{"type":"object","required":["fromChainId","toChainId","fromToken","toToken","fromAmount","toAmount","toAmountMin","executionDuration","quoteTimestamp","expiresAt"],"properties":{"fromChainId":{"type":"string"},"toChainId":{"type":"string"},"fromToken":{"$ref":"#/components/schemas/SwapToken"},"toToken":{"$ref":"#/components/schemas/SwapToken"},"fromAmount":{"type":"string"},"fromAmountUSD":{"type":"string"},"toAmount":{"type":"string"},"toAmountUSD":{"type":"string"},"toAmountMin":{"type":"string"},"feeCosts":{"type":"array","items":{"$ref":"#/components/schemas/SwapFeeCost"}},"gasCosts":{"type":"array","items":{"$ref":"#/components/schemas/SwapGasCost"}},"totalSwapFeeUSD":{"type":"number"},"totalGasUSD":{"type":"number"},"executionDuration":{"type":"integer"},"quoteTimestamp":{"type":"string"},"expiresAt":{"$ref":"#/components/schemas/Timestamp"},"route":{"type":"object"}}},"SwapBuildRequest":{"type":"object","required":["fromChainId","toChainId","fromTokenAddress","toTokenAddress","fromAmount","minToAmount","sender","recipient"],"properties":{"fromChainId":{"oneOf":[{"$ref":"#/components/schemas/ChainId"},{"type":"string"}]},"toChainId":{"oneOf":[{"$ref":"#/components/schemas/ChainId"},{"type":"string"}]},"fromTokenAddress":{"$ref":"#/components/schemas/Address"},"toTokenAddress":{"$ref":"#/components/schemas/Address"},"fromAmount":{"$ref":"#/components/schemas/Amount"},"minToAmount":{"$ref":"#/components/schemas/Amount"},"sender":{"$ref":"#/components/schemas/Address"},"recipient":{"$ref":"#/components/schemas/Address"}}},"SwapBuildResponse":{"type":"object","required":["resolvedSwap","approval","transaction","fees","expiresAt","notes"],"properties":{"resolvedSwap":{"type":"object","properties":{"fromChainId":{"type":"string"},"toChainId":{"type":"string"},"fromToken":{"$ref":"#/components/schemas/Address"},"toToken":{"$ref":"#/components/schemas/Address"},"fromAmount":{"type":"string"},"toAmount":{"type":"string"},"toAmountMin":{"type":"string"},"sender":{"$ref":"#/components/schemas/Address"},"recipient":{"$ref":"#/components/schemas/Address"}}},"approval":{"$ref":"#/components/schemas/Approval"},"transaction":{"$ref":"#/components/schemas/UnsignedTransactionRequest"},"fees":{"type":"object","properties":{"feeCosts":{"type":"array","items":{"$ref":"#/components/schemas/SwapFeeCost"}},"gasCosts":{"type":"array","items":{"$ref":"#/components/schemas/SwapGasCost"}},"totalSwapFeeUSD":{"type":"number"},"totalGasUSD":{"type":"number"}}},"expiresAt":{"$ref":"#/components/schemas/Timestamp"},"notes":{"type":"array","items":{"type":"string"}}}},"SwapStatus":{"type":"string","enum":["opened","settled","refunded","failed","on_hold"]},"SwapTransactionStatusResponse":{"type":"object","required":["txHash","recognized"],"properties":{"txHash":{"$ref":"#/components/schemas/TxHash"},"recognized":{"type":"boolean"},"status":{"oneOf":[{"$ref":"#/components/schemas/SwapStatus"},{"type":"null"}]},"source":{"type":["object","null"],"properties":{"chainId":{"type":"string"},"txHash":{"type":"string"},"explorerUrl":{"type":["string","null"]},"timestamp":{"$ref":"#/components/schemas/NullableTimestamp"}}},"destination":{"type":["object","null"],"properties":{"chainId":{"type":"string"},"txHash":{"type":"string"},"explorerUrl":{"type":["string","null"]},"timestamp":{"$ref":"#/components/schemas/NullableTimestamp"}}},"input":{"type":["object","null"],"properties":{"token":{"type":"string"},"amount":{"type":"string"},"priceUSD":{"type":["string","null"]}}},"output":{"type":["object","null"],"properties":{"token":{"type":"string"},"amount":{"type":["string","null"]},"priceUSD":{"type":["string","null"]}}},"fees":{"type":["object","null"],"properties":{"relayerFee":{"type":"string"},"swapFee":{"type":"string"}}},"timestamps":{"type":["object","null"],"properties":{"openedAt":{"$ref":"#/components/schemas/NullableTimestamp"},"completedAt":{"$ref":"#/components/schemas/NullableTimestamp"},"refundedAt":{"$ref":"#/components/schemas/NullableTimestamp"}}}}},"SwapOrder":{"type":"object","required":["txHash","status","fromChainId","toChainId"],"properties":{"txHash":{"type":"string"},"status":{"$ref":"#/components/schemas/SwapStatus"},"fromChainId":{"type":"string"},"toChainId":{"type":"string"},"fromToken":{"type":"string"},"toToken":{"type":"string"},"fromAmount":{"type":"string"},"toAmount":{"type":["string","null"]},"relayerFee":{"type":"string"},"swapFee":{"type":"string"},"openedAt":{"$ref":"#/components/schemas/NullableTimestamp"},"completedAt":{"$ref":"#/components/schemas/NullableTimestamp"},"refundedAt":{"$ref":"#/components/schemas/NullableTimestamp"}}},"SwapUserOrdersResponse":{"type":"object","required":["address","orders","count","limit"],"properties":{"address":{"$ref":"#/components/schemas/Address"},"orders":{"type":"array","items":{"$ref":"#/components/schemas/SwapOrder"}},"count":{"type":"integer"},"limit":{"$ref":"#/components/schemas/UserOrderLimit"}}}}}}