{"openapi":"3.1.0","info":{"title":"Anyflo API","version":"0.1.0"},"components":{"securitySchemes":{"customerApiKey":{"type":"http","scheme":"bearer","bearerFormat":"anyflo_sk_<secret>","description":"Customer API key, e.g. anyflo_sk_<32 base32 chars>"}},"schemas":{"BigInt":{"type":"string","pattern":"^(0|[1-9]\\d*)$","description":"Non-negative BigInt represented as a decimal string","example":"1000000000000000000"},"PositiveBigInt":{"type":"string","pattern":"^[1-9]\\d*$","description":"Positive BigInt represented as a decimal string (>= 1)","example":"1"}},"parameters":{}},"paths":{"/v1/customer/register-user":{"post":{"security":[{"customerApiKey":[]}],"tags":["Customer"],"summary":"Allow customer to register their users","operationId":"post_RegisterUser","requestBody":{"content":{"application/cbor":{"schema":{"type":"object","properties":{"externalUserId":{"type":"string","minLength":1,"maxLength":256}},"required":["externalUserId"]}},"application/json":{"schema":{"type":"object","properties":{"externalUserId":{"type":"string","minLength":1,"maxLength":256}},"required":["externalUserId"]}}}},"responses":{"200":{"description":"User ID","content":{"application/cbor":{"schema":{"type":"string","format":"uuid"}},"application/json":{"schema":{"type":"string","format":"uuid"}}}},"400":{"description":"Input Validation Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}}},"required":["success","errors"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"}},"required":["code","message"]}}},"required":["success","errors"]}}}},"415":{"description":"Unsupported Content-Type (use application/json or application/cbor)","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"500":{"description":"Internal Server Error","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/customer/orders":{"get":{"security":[{"customerApiKey":[]}],"tags":["Customer"],"summary":"Browse all orders belonging to the authenticated customer","operationId":"get_BrowseCustomerOrders","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":30,"description":"Number of items to fetch from start"},"required":false,"description":"Number of items to fetch from start","name":"first","in":"query"},{"schema":{"type":"string","description":"Cursor for fetching items after a specific point"},"required":false,"description":"Cursor for fetching items after a specific point","name":"after","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":30,"description":"Number of items to fetch from the end"},"required":false,"description":"Number of items to fetch from the end","name":"last","in":"query"},{"schema":{"type":"string","description":"Cursor for fetching items before a specific point"},"required":false,"description":"Cursor for fetching items before a specific point","name":"before","in":"query"},{"schema":{"type":"array","items":{"type":"string","enum":["new","rejected","expired","bidding","selected","accepted","executing","delivered","depositNotAck","deliveryNotAck","cancelled"]},"description":"Filter by order status(es)"},"required":false,"description":"Filter by order status(es)","name":"status","in":"query"},{"schema":{"type":"array","items":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"description":"Filter by sender chain(s)"},"required":false,"description":"Filter by sender chain(s)","name":"senderChain","in":"query"},{"schema":{"type":"array","items":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"description":"Filter by recipient chain(s)"},"required":false,"description":"Filter by recipient chain(s)","name":"recipientChain","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"description":"Filter start epoch ms"},"required":false,"description":"Filter start epoch ms","name":"startDate","in":"query"},{"schema":{"type":"integer","exclusiveMinimum":0,"description":"Filter end epoch ms"},"required":false,"description":"Filter end epoch ms","name":"endDate","in":"query"}],"responses":{"200":{"description":"List of orders related to the given Customer Id with page info","content":{"application/cbor":{"schema":{"type":"object","properties":{"orders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"senderId":{"type":"string","format":"uuid"},"recipientId":{"type":["string","null"],"format":"uuid"},"senderAddr":{"type":"string"},"recipientAddr":{"type":"string"},"senderChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"recipientChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"tokenIn":{"type":"string"},"amountIn":{"$ref":"#/components/schemas/BigInt"},"tokenOut":{"type":"string"},"amountOut":{"$ref":"#/components/schemas/BigInt"},"typ":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]}]},"status":{"type":"string","enum":["new","rejected","expired","bidding","selected","accepted","executing","delivered","depositNotAck","deliveryNotAck","cancelled"]},"solverId":{"type":["number","null"]},"solverAddress":{"type":["string","null"]},"directDeposit":{"type":"boolean","default":false},"fee":{"allOf":[{"$ref":"#/components/schemas/BigInt"},{"type":["string","null"]}]},"feeRecipient":{"type":["string","null"]},"depositExpiresAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":"number"},"deliverTx":{"type":["string","null"]},"reorgedDeliveryTxs":{"type":"array","items":{"type":"string"}},"depositReorgedAt":{"type":["number","null"]}},"required":["id","senderId","recipientId","senderAddr","recipientAddr","senderChain","recipientChain","tokenIn","amountIn","tokenOut","amountOut","typ","status","solverId","solverAddress","fee","feeRecipient","depositExpiresAt","createdAt","updatedAt"]}},"pageInfo":{"type":"object","properties":{"hasNextPage":{"type":"boolean","description":"Indicates if there are more items when paginating forward."},"endCursor":{"type":["string","null"],"minLength":1,"description":"End cursor"},"hasPreviousPage":{"type":"boolean","description":"Indicates if there are more items when paginating backward."},"startCursor":{"type":["string","null"],"minLength":1,"description":"Start cursor"}},"required":["hasNextPage","endCursor","hasPreviousPage","startCursor"]}},"required":["orders","pageInfo"]}},"application/json":{"schema":{"type":"object","properties":{"orders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"senderId":{"type":"string","format":"uuid"},"recipientId":{"type":["string","null"],"format":"uuid"},"senderAddr":{"type":"string"},"recipientAddr":{"type":"string"},"senderChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"recipientChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"tokenIn":{"type":"string"},"amountIn":{"$ref":"#/components/schemas/BigInt"},"tokenOut":{"type":"string"},"amountOut":{"$ref":"#/components/schemas/BigInt"},"typ":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]}]},"status":{"type":"string","enum":["new","rejected","expired","bidding","selected","accepted","executing","delivered","depositNotAck","deliveryNotAck","cancelled"]},"solverId":{"type":["number","null"]},"solverAddress":{"type":["string","null"]},"directDeposit":{"type":"boolean","default":false},"fee":{"allOf":[{"$ref":"#/components/schemas/BigInt"},{"type":["string","null"]}]},"feeRecipient":{"type":["string","null"]},"depositExpiresAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":"number"},"deliverTx":{"type":["string","null"]},"reorgedDeliveryTxs":{"type":"array","items":{"type":"string"}},"depositReorgedAt":{"type":["number","null"]}},"required":["id","senderId","recipientId","senderAddr","recipientAddr","senderChain","recipientChain","tokenIn","amountIn","tokenOut","amountOut","typ","status","solverId","solverAddress","fee","feeRecipient","depositExpiresAt","createdAt","updatedAt"]}},"pageInfo":{"type":"object","properties":{"hasNextPage":{"type":"boolean","description":"Indicates if there are more items when paginating forward."},"endCursor":{"type":["string","null"],"minLength":1,"description":"End cursor"},"hasPreviousPage":{"type":"boolean","description":"Indicates if there are more items when paginating backward."},"startCursor":{"type":["string","null"],"minLength":1,"description":"Start cursor"}},"required":["hasNextPage","endCursor","hasPreviousPage","startCursor"]}},"required":["orders","pageInfo"]}}}},"400":{"description":"Input Validation Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}}},"required":["success","errors"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"}},"required":["code","message"]}}},"required":["success","errors"]}}}},"415":{"description":"Unsupported Content-Type (use application/json or application/cbor)","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"500":{"description":"Internal Server Error","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/customer/orders/pending-deposit":{"get":{"security":[{"customerApiKey":[]}],"tags":["Customer"],"summary":"Stale accepted orders awaiting an on-chain deposit","operationId":"get_PendingDepositOrders","parameters":[{"schema":{"type":"integer","exclusiveMinimum":0,"description":"Staleness threshold in milliseconds. Defaults to DEFAULT_DEPOSIT_STALE_THRESHOLD_MS (10 minutes)."},"required":false,"description":"Staleness threshold in milliseconds. Defaults to DEFAULT_DEPOSIT_STALE_THRESHOLD_MS (10 minutes).","name":"thresholdMs","in":"query"}],"responses":{"200":{"description":"Stale accepted orders awaiting on-chain deposit","content":{"application/cbor":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"senderId":{"type":"string","format":"uuid"},"recipientId":{"type":["string","null"],"format":"uuid"},"senderAddr":{"type":"string"},"recipientAddr":{"type":"string"},"senderChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"recipientChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"tokenIn":{"type":"string"},"amountIn":{"$ref":"#/components/schemas/BigInt"},"tokenOut":{"type":"string"},"amountOut":{"$ref":"#/components/schemas/BigInt"},"typ":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]}]},"status":{"type":"string","enum":["new","rejected","expired","bidding","selected","accepted","executing","delivered","depositNotAck","deliveryNotAck","cancelled"]},"solverId":{"type":["number","null"]},"solverAddress":{"type":["string","null"]},"directDeposit":{"type":"boolean","default":false},"fee":{"allOf":[{"$ref":"#/components/schemas/BigInt"},{"type":["string","null"]}]},"feeRecipient":{"type":["string","null"]},"depositExpiresAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":"number"},"deliverTx":{"type":["string","null"]},"reorgedDeliveryTxs":{"type":"array","items":{"type":"string"}},"depositReorgedAt":{"type":["number","null"]}},"required":["id","senderId","recipientId","senderAddr","recipientAddr","senderChain","recipientChain","tokenIn","amountIn","tokenOut","amountOut","typ","status","solverId","solverAddress","fee","feeRecipient","depositExpiresAt","createdAt","updatedAt"]}}},"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"senderId":{"type":"string","format":"uuid"},"recipientId":{"type":["string","null"],"format":"uuid"},"senderAddr":{"type":"string"},"recipientAddr":{"type":"string"},"senderChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"recipientChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"tokenIn":{"type":"string"},"amountIn":{"$ref":"#/components/schemas/BigInt"},"tokenOut":{"type":"string"},"amountOut":{"$ref":"#/components/schemas/BigInt"},"typ":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]}]},"status":{"type":"string","enum":["new","rejected","expired","bidding","selected","accepted","executing","delivered","depositNotAck","deliveryNotAck","cancelled"]},"solverId":{"type":["number","null"]},"solverAddress":{"type":["string","null"]},"directDeposit":{"type":"boolean","default":false},"fee":{"allOf":[{"$ref":"#/components/schemas/BigInt"},{"type":["string","null"]}]},"feeRecipient":{"type":["string","null"]},"depositExpiresAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":"number"},"deliverTx":{"type":["string","null"]},"reorgedDeliveryTxs":{"type":"array","items":{"type":"string"}},"depositReorgedAt":{"type":["number","null"]}},"required":["id","senderId","recipientId","senderAddr","recipientAddr","senderChain","recipientChain","tokenIn","amountIn","tokenOut","amountOut","typ","status","solverId","solverAddress","fee","feeRecipient","depositExpiresAt","createdAt","updatedAt"]}}}}},"400":{"description":"Input Validation Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}}},"required":["success","errors"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"}},"required":["code","message"]}}},"required":["success","errors"]}}}},"415":{"description":"Unsupported Content-Type (use application/json or application/cbor)","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"500":{"description":"Internal Server Error","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/customer/balance":{"get":{"security":[{"customerApiKey":[]}],"tags":["Customer"],"summary":"Get required balance and current reserve status for authenticated customer","operationId":"get_CustomerBalance","responses":{"200":{"description":"Customer reserve balance details","content":{"application/cbor":{"schema":{"type":"object","properties":{"requiredBalanceCents":{"type":"integer","minimum":0,"description":"Required reserve balance in USD cents"},"currentBalanceCents":{"type":"integer","minimum":0,"description":"Current deposited reserve balance in USD cents"},"isCompliant":{"type":"boolean","description":"True if current balance meets or exceeds required balance"}},"required":["requiredBalanceCents","currentBalanceCents","isCompliant"]}},"application/json":{"schema":{"type":"object","properties":{"requiredBalanceCents":{"type":"integer","minimum":0,"description":"Required reserve balance in USD cents"},"currentBalanceCents":{"type":"integer","minimum":0,"description":"Current deposited reserve balance in USD cents"},"isCompliant":{"type":"boolean","description":"True if current balance meets or exceeds required balance"}},"required":["requiredBalanceCents","currentBalanceCents","isCompliant"]}}}},"400":{"description":"Input Validation Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}}},"required":["success","errors"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"}},"required":["code","message"]}}},"required":["success","errors"]}}}},"415":{"description":"Unsupported Content-Type (use application/json or application/cbor)","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"500":{"description":"Internal Server Error","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/customer/volume":{"get":{"security":[{"customerApiKey":[]}],"tags":["Customer"],"summary":"Get 30-day volume details for authenticated customer","operationId":"get_CustomerVolume","responses":{"200":{"description":"Customer 30-day volume details","content":{"application/cbor":{"schema":{"type":"object","properties":{"volumeCents":{"type":"integer","minimum":0,"description":"Effective 30-day volume in USD cents"},"isExtrapolated":{"type":"boolean","description":"True if volume is run-rate extrapolated due to history < 30 days"}},"required":["volumeCents","isExtrapolated"]}},"application/json":{"schema":{"type":"object","properties":{"volumeCents":{"type":"integer","minimum":0,"description":"Effective 30-day volume in USD cents"},"isExtrapolated":{"type":"boolean","description":"True if volume is run-rate extrapolated due to history < 30 days"}},"required":["volumeCents","isExtrapolated"]}}}},"400":{"description":"Input Validation Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}}},"required":["success","errors"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"}},"required":["code","message"]}}},"required":["success","errors"]}}}},"415":{"description":"Unsupported Content-Type (use application/json or application/cbor)","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"500":{"description":"Internal Server Error","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/customer/rate-card":{"get":{"security":[{"customerApiKey":[]}],"tags":["Customer"],"summary":"Get effective rate card for authenticated customer","operationId":"get_CustomerRateCard","responses":{"200":{"description":"Customer effective rate card details","content":{"application/cbor":{"schema":{"type":"object","properties":{"flatRateBps":{"type":"integer","minimum":0},"liquidityBps":{"type":"integer","minimum":0},"settlementBps":{"type":"integer","minimum":0},"baseTiers":{"type":"array","items":{"type":"object","properties":{"minVolume":{"type":"number","minimum":0},"bps":{"type":"integer","minimum":0}},"required":["minVolume","bps"]},"description":"Active rate tiers (custom or system default)"},"isBespoke":{"type":"boolean","description":"True if customer has custom rate card overrides configured"}},"required":["baseTiers","isBespoke"]}},"application/json":{"schema":{"type":"object","properties":{"flatRateBps":{"type":"integer","minimum":0},"liquidityBps":{"type":"integer","minimum":0},"settlementBps":{"type":"integer","minimum":0},"baseTiers":{"type":"array","items":{"type":"object","properties":{"minVolume":{"type":"number","minimum":0},"bps":{"type":"integer","minimum":0}},"required":["minVolume","bps"]},"description":"Active rate tiers (custom or system default)"},"isBespoke":{"type":"boolean","description":"True if customer has custom rate card overrides configured"}},"required":["baseTiers","isBespoke"]}}}},"400":{"description":"Input Validation Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}}},"required":["success","errors"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"}},"required":["code","message"]}}},"required":["success","errors"]}}}},"415":{"description":"Unsupported Content-Type (use application/json or application/cbor)","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"500":{"description":"Internal Server Error","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/orders/{id}":{"get":{"security":[{"customerApiKey":[]}],"tags":["Orders"],"summary":"Query order by ID with optional detail overlays","operationId":"get_OrderById","parameters":[{"schema":{"type":"string","format":"uuid","description":"Order UUID"},"required":true,"description":"Order UUID","name":"id","in":"path"},{"schema":{"anyOf":[{"type":"boolean"},{"type":"string","enum":["true","false"]}],"description":"Include order transaction history"},"required":false,"description":"Include order transaction history","name":"txs","in":"query"},{"schema":{"anyOf":[{"type":"boolean"},{"type":"string","enum":["true","false"]}],"description":"Include payment instructions"},"required":false,"description":"Include payment instructions","name":"instructions","in":"query"}],"responses":{"200":{"description":"Order detail payload","content":{"application/cbor":{"schema":{"type":"object","properties":{"order":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"senderId":{"type":"string","format":"uuid"},"recipientId":{"type":["string","null"],"format":"uuid"},"senderAddr":{"type":"string"},"recipientAddr":{"type":"string"},"senderChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"recipientChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"tokenIn":{"type":"string"},"amountIn":{"$ref":"#/components/schemas/BigInt"},"tokenOut":{"type":"string"},"amountOut":{"$ref":"#/components/schemas/BigInt"},"typ":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]}]},"status":{"type":"string","enum":["new","rejected","expired","bidding","selected","accepted","executing","delivered","depositNotAck","deliveryNotAck","cancelled"]},"solverId":{"type":["number","null"]},"solverAddress":{"type":["string","null"]},"directDeposit":{"type":"boolean","default":false},"fee":{"allOf":[{"$ref":"#/components/schemas/BigInt"},{"type":["string","null"]}]},"feeRecipient":{"type":["string","null"]},"depositExpiresAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":"number"},"deliverTx":{"type":["string","null"]},"reorgedDeliveryTxs":{"type":"array","items":{"type":"string"}},"depositReorgedAt":{"type":["number","null"]}},"required":["id","senderId","recipientId","senderAddr","recipientAddr","senderChain","recipientChain","tokenIn","amountIn","tokenOut","amountOut","typ","status","solverId","solverAddress","fee","feeRecipient","depositExpiresAt","createdAt","updatedAt"]},"instructions":{"type":"object","properties":{"target":{"type":"string"},"tokens":{"type":"array","items":{"type":"string"}},"amounts":{"type":"array","items":{"$ref":"#/components/schemas/BigInt"}},"fees":{"type":"array","items":{"$ref":"#/components/schemas/BigInt"}},"directDeposit":{"type":"boolean"},"solverAddress":{"type":"string","minLength":3},"depositExpiresAt":{"type":"number"},"signature":{"type":"string"}},"required":["target","tokens","amounts","fees","directDeposit","solverAddress","depositExpiresAt","signature"]},"txs":{"type":"object","properties":{"depositTxs":{"type":"array","items":{"type":"object","properties":{"txHash":{"type":"string"},"timestamp":{"type":"number"}},"required":["txHash","timestamp"]}},"deliverTxs":{"type":"array","items":{"type":"object","properties":{"txHash":{"type":"string"},"timestamp":{"type":"number"}},"required":["txHash","timestamp"]}}},"required":["depositTxs","deliverTxs"]}},"required":["order"]}},"application/json":{"schema":{"type":"object","properties":{"order":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"senderId":{"type":"string","format":"uuid"},"recipientId":{"type":["string","null"],"format":"uuid"},"senderAddr":{"type":"string"},"recipientAddr":{"type":"string"},"senderChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"recipientChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"tokenIn":{"type":"string"},"amountIn":{"$ref":"#/components/schemas/BigInt"},"tokenOut":{"type":"string"},"amountOut":{"$ref":"#/components/schemas/BigInt"},"typ":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]}]},"status":{"type":"string","enum":["new","rejected","expired","bidding","selected","accepted","executing","delivered","depositNotAck","deliveryNotAck","cancelled"]},"solverId":{"type":["number","null"]},"solverAddress":{"type":["string","null"]},"directDeposit":{"type":"boolean","default":false},"fee":{"allOf":[{"$ref":"#/components/schemas/BigInt"},{"type":["string","null"]}]},"feeRecipient":{"type":["string","null"]},"depositExpiresAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":"number"},"deliverTx":{"type":["string","null"]},"reorgedDeliveryTxs":{"type":"array","items":{"type":"string"}},"depositReorgedAt":{"type":["number","null"]}},"required":["id","senderId","recipientId","senderAddr","recipientAddr","senderChain","recipientChain","tokenIn","amountIn","tokenOut","amountOut","typ","status","solverId","solverAddress","fee","feeRecipient","depositExpiresAt","createdAt","updatedAt"]},"instructions":{"type":"object","properties":{"target":{"type":"string"},"tokens":{"type":"array","items":{"type":"string"}},"amounts":{"type":"array","items":{"$ref":"#/components/schemas/BigInt"}},"fees":{"type":"array","items":{"$ref":"#/components/schemas/BigInt"}},"directDeposit":{"type":"boolean"},"solverAddress":{"type":"string","minLength":3},"depositExpiresAt":{"type":"number"},"signature":{"type":"string"}},"required":["target","tokens","amounts","fees","directDeposit","solverAddress","depositExpiresAt","signature"]},"txs":{"type":"object","properties":{"depositTxs":{"type":"array","items":{"type":"object","properties":{"txHash":{"type":"string"},"timestamp":{"type":"number"}},"required":["txHash","timestamp"]}},"deliverTxs":{"type":"array","items":{"type":"object","properties":{"txHash":{"type":"string"},"timestamp":{"type":"number"}},"required":["txHash","timestamp"]}}},"required":["depositTxs","deliverTxs"]}},"required":["order"]}}}},"400":{"description":"Input Validation Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}}},"required":["success","errors"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"}},"required":["code","message"]}}},"required":["success","errors"]}}}},"415":{"description":"Unsupported Content-Type (use application/json or application/cbor)","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"500":{"description":"Internal Server Error","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/orders/customer-user/{customerId}/{userId}":{"get":{"security":[{"customerApiKey":[]}],"tags":["Orders"],"summary":"Query orders matching given user as sender or recipient","operationId":"get_OrdersByCustomerUser","parameters":[{"schema":{"type":"string","format":"uuid","description":"Customer UUID"},"required":true,"description":"Customer UUID","name":"customerId","in":"path"},{"schema":{"type":"string","format":"uuid","description":"User UUID"},"required":true,"description":"User UUID","name":"userId","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":30,"description":"Number of items to fetch from start"},"required":false,"description":"Number of items to fetch from start","name":"first","in":"query"},{"schema":{"type":"string","description":"Cursor for fetching items after a specific point"},"required":false,"description":"Cursor for fetching items after a specific point","name":"after","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":30,"description":"Number of items to fetch from the end"},"required":false,"description":"Number of items to fetch from the end","name":"last","in":"query"},{"schema":{"type":"string","description":"Cursor for fetching items before a specific point"},"required":false,"description":"Cursor for fetching items before a specific point","name":"before","in":"query"},{"schema":{"type":"array","items":{"type":"string","enum":["new","rejected","expired","bidding","selected","accepted","executing","delivered","depositNotAck","deliveryNotAck","cancelled"]},"description":"Filter by order status"},"required":false,"description":"Filter by order status","name":"status","in":"query"},{"schema":{"allOf":[{"$ref":"#/components/schemas/BigInt"},{"description":"Min inclusive amount (bigint string)"}]},"required":false,"description":"Min inclusive amount (bigint string)","name":"amountFrom","in":"query"},{"schema":{"allOf":[{"$ref":"#/components/schemas/BigInt"},{"description":"Max inclusive amount (bigint string)"}]},"required":false,"description":"Max inclusive amount (bigint string)","name":"amountTo","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"description":"Start timestamp"},"required":false,"description":"Start timestamp","name":"dateFrom","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"description":"End timestamp"},"required":false,"description":"End timestamp","name":"dateTo","in":"query"}],"responses":{"200":{"description":"List of orders related to the given Customer Id and UserId with page info","content":{"application/cbor":{"schema":{"type":"object","properties":{"orders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"senderId":{"type":"string","format":"uuid"},"recipientId":{"type":["string","null"],"format":"uuid"},"senderAddr":{"type":"string"},"recipientAddr":{"type":"string"},"senderChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"recipientChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"tokenIn":{"type":"string"},"amountIn":{"$ref":"#/components/schemas/BigInt"},"tokenOut":{"type":"string"},"amountOut":{"$ref":"#/components/schemas/BigInt"},"typ":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]}]},"status":{"type":"string","enum":["new","rejected","expired","bidding","selected","accepted","executing","delivered","depositNotAck","deliveryNotAck","cancelled"]},"solverId":{"type":["number","null"]},"solverAddress":{"type":["string","null"]},"directDeposit":{"type":"boolean","default":false},"fee":{"allOf":[{"$ref":"#/components/schemas/BigInt"},{"type":["string","null"]}]},"feeRecipient":{"type":["string","null"]},"depositExpiresAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":"number"},"deliverTx":{"type":["string","null"]},"reorgedDeliveryTxs":{"type":"array","items":{"type":"string"}},"depositReorgedAt":{"type":["number","null"]}},"required":["id","senderId","recipientId","senderAddr","recipientAddr","senderChain","recipientChain","tokenIn","amountIn","tokenOut","amountOut","typ","status","solverId","solverAddress","fee","feeRecipient","depositExpiresAt","createdAt","updatedAt"]}},"pageInfo":{"type":"object","properties":{"hasNextPage":{"type":"boolean","description":"Indicates if there are more items when paginating forward."},"endCursor":{"type":["string","null"],"minLength":1,"description":"End cursor"},"hasPreviousPage":{"type":"boolean","description":"Indicates if there are more items when paginating backward."},"startCursor":{"type":["string","null"],"minLength":1,"description":"Start cursor"}},"required":["hasNextPage","endCursor","hasPreviousPage","startCursor"]}},"required":["orders","pageInfo"]}},"application/json":{"schema":{"type":"object","properties":{"orders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"senderId":{"type":"string","format":"uuid"},"recipientId":{"type":["string","null"],"format":"uuid"},"senderAddr":{"type":"string"},"recipientAddr":{"type":"string"},"senderChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"recipientChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"tokenIn":{"type":"string"},"amountIn":{"$ref":"#/components/schemas/BigInt"},"tokenOut":{"type":"string"},"amountOut":{"$ref":"#/components/schemas/BigInt"},"typ":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]}]},"status":{"type":"string","enum":["new","rejected","expired","bidding","selected","accepted","executing","delivered","depositNotAck","deliveryNotAck","cancelled"]},"solverId":{"type":["number","null"]},"solverAddress":{"type":["string","null"]},"directDeposit":{"type":"boolean","default":false},"fee":{"allOf":[{"$ref":"#/components/schemas/BigInt"},{"type":["string","null"]}]},"feeRecipient":{"type":["string","null"]},"depositExpiresAt":{"type":["number","null"]},"createdAt":{"type":"number"},"updatedAt":{"type":"number"},"deliverTx":{"type":["string","null"]},"reorgedDeliveryTxs":{"type":"array","items":{"type":"string"}},"depositReorgedAt":{"type":["number","null"]}},"required":["id","senderId","recipientId","senderAddr","recipientAddr","senderChain","recipientChain","tokenIn","amountIn","tokenOut","amountOut","typ","status","solverId","solverAddress","fee","feeRecipient","depositExpiresAt","createdAt","updatedAt"]}},"pageInfo":{"type":"object","properties":{"hasNextPage":{"type":"boolean","description":"Indicates if there are more items when paginating forward."},"endCursor":{"type":["string","null"],"minLength":1,"description":"End cursor"},"hasPreviousPage":{"type":"boolean","description":"Indicates if there are more items when paginating backward."},"startCursor":{"type":["string","null"],"minLength":1,"description":"Start cursor"}},"required":["hasNextPage","endCursor","hasPreviousPage","startCursor"]}},"required":["orders","pageInfo"]}}}},"400":{"description":"Input Validation Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}}},"required":["success","errors"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"}},"required":["code","message"]}}},"required":["success","errors"]}}}},"415":{"description":"Unsupported Content-Type (use application/json or application/cbor)","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"500":{"description":"Internal Server Error","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/orders":{"post":{"security":[{"customerApiKey":[]}],"tags":["Orders"],"summary":"Create a new order","operationId":"post_OrderCreate","requestBody":{"content":{"application/cbor":{"schema":{"type":"object","properties":{"senderId":{"type":"string","format":"uuid"},"recipientId":{"type":"string","format":"uuid"},"senderAddr":{"type":"string","minLength":1},"recipientAddr":{"type":"string","minLength":1},"senderChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"recipientChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"tokenIn":{"type":"string","minLength":1},"tokenOut":{"type":"string","minLength":1},"typ":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]}],"description":"Order type (1: fixed input, 2: fixed output)"},"amount":{"allOf":[{"$ref":"#/components/schemas/PositiveBigInt"},{"description":"Token amount (input amount for typ=1, output amount for typ=2)"}]},"idempotencyKey":{"type":"string","minLength":1,"maxLength":128,"description":"Optional per-customer anti-replay idempotency key. When supplied, reusing the same (customer, key) is rejected with Conflict; the original order is not returned."}},"required":["senderId","senderAddr","recipientAddr","senderChain","recipientChain","tokenIn","tokenOut","typ","amount"]}},"application/json":{"schema":{"type":"object","properties":{"senderId":{"type":"string","format":"uuid"},"recipientId":{"type":"string","format":"uuid"},"senderAddr":{"type":"string","minLength":1},"recipientAddr":{"type":"string","minLength":1},"senderChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"recipientChain":{"type":"string","enum":["eip155:84532","eip155:80002","eip155:421614","eip155:31337","eip155:8453","eip155:137","eip155:42161","sui:testnet","sui:mainnet","sui:devnet","sui:localnet"]},"tokenIn":{"type":"string","minLength":1},"tokenOut":{"type":"string","minLength":1},"typ":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[2]}],"description":"Order type (1: fixed input, 2: fixed output)"},"amount":{"allOf":[{"$ref":"#/components/schemas/PositiveBigInt"},{"description":"Token amount (input amount for typ=1, output amount for typ=2)"}]},"idempotencyKey":{"type":"string","minLength":1,"maxLength":128,"description":"Optional per-customer anti-replay idempotency key. When supplied, reusing the same (customer, key) is rejected with Conflict; the original order is not returned."}},"required":["senderId","senderAddr","recipientAddr","senderChain","recipientChain","tokenIn","tokenOut","typ","amount"]}}}},"responses":{"200":{"description":"Order ID","content":{"application/cbor":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Order UUID"}},"required":["id"]}},"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Order UUID"}},"required":["id"]}}}},"400":{"description":"Input Validation Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}}},"required":["success","errors"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"}},"required":["code","message"]}}},"required":["success","errors"]}}}},"415":{"description":"Unsupported Content-Type (use application/json or application/cbor)","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"500":{"description":"Internal Server Error","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/orders/{id}/cancel":{"post":{"security":[{"customerApiKey":[]}],"tags":["Orders"],"summary":"Cancel an order before payment","description":"Cancels an order from `new`, `bidding`, `selected`, or `accepted` status. Informs the assigned solver (if any). Idempotent: re-cancelling an already `cancelled` order returns success. The `customerId` must own `order.senderId`.","operationId":"post_OrderCancel","parameters":[{"schema":{"type":"string","format":"uuid","description":"Order UUID"},"required":true,"description":"Order UUID","name":"id","in":"path"}],"requestBody":{"content":{"application/cbor":{"schema":{"type":"object","properties":{"reason":{"type":"string","maxLength":500,"description":"Optional free-text cancellation reason"}},"description":"Cancel order request"}},"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","maxLength":500,"description":"Optional free-text cancellation reason"}},"description":"Cancel order request"}}}},"responses":{"200":{"description":"Order cancelled successfully","content":{"application/cbor":{"schema":{"type":"null"}},"application/json":{"schema":{"type":"null"}}}},"400":{"description":"Input Validation Error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"},"path":{"type":"array","items":{"type":"string"}}},"required":["code","message","path"]}}},"required":["success","errors"]}}}},"401":{"description":"Missing or invalid authentication","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number"},"message":{"type":"string"}},"required":["code","message"]}}},"required":["success","errors"]}}}},"415":{"description":"Unsupported Content-Type (use application/json or application/cbor)","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"500":{"description":"Internal Server Error","content":{"application/cbor":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}},"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/notification/ws-connect":{"get":{"security":[{"customerApiKey":[]}],"tags":["Notifications"],"summary":"Connect to notification websocket","description":"Subscribes the authenticated customer to order status events for all of its users. The customer is derived from the API key; no query parameters are accepted.","operationId":"get_NotificationWsConnect","responses":{"101":{"description":"WebSocket connection established"},"426":{"description":"Missing Upgrade: websocket header"}}}}},"webhooks":{}}