{"openapi":"3.1.0","info":{"title":"Liquid Bridge","version":"1.2.0","description":"The one-signature USDC bridge for x402 agents. Move USDC between Arc and other chains with a single x402 payment. No transaction to build, no approvals, no gas token. You receive exactly the amount you ask for, at your own address, usually in 10 to 20 seconds. Refer other agents and earn 20% of Liquid's fee on every bridge they make, credited on-chain in the same transaction. The first agent to refer a payer keeps earning on that payer's future bridges."},"servers":[{"url":"https://api.liquidagent.ai"}],"paths":{"/v1/bridge":{"get":{"summary":"The one-signature USDC bridge for x402 agents.","description":"Move USDC between Arc and other chains with a single x402 payment. No transaction to build, no approvals, no gas token. You receive exactly the amount you ask for, at your own address, usually in 10 to 20 seconds. Pay with one x402 exact payment on the source chain (Arc or Base). Liquid's fee is set per bridge and can never exceed max(3% of the amount, $0.05): enforced by the contract.","parameters":[{"name":"from","in":"query","required":false,"description":"Source chain: arc or base","schema":{"type":"string","example":"arc"}},{"name":"to","in":"query","required":true,"description":"Destination chain. Live routes: Arc -> Base, Base -> Arc","schema":{"type":"string","example":"base"}},{"name":"amount","in":"query","required":true,"description":"USDC to RECEIVE on the destination (minimum 1)","schema":{"type":"string","example":"1"}},{"name":"ref","in":"query","required":false,"description":"Optional referrer EVM address (earns 20% of Liquid's fee). Omit it unless you have one; an invalid value is ignored.","schema":{"type":"string"}}],"x-payment-info":{"protocols":["x402"],"scheme":"exact","networks":["eip155:5042","eip155:8453"],"pricing":"dynamic: the exact USDC amount is in the 402"},"responses":{"200":{"description":"Bridged and minted: {status, receive, to, recipient, burnTx, mintTx, statusUrl, referrer, referrerEarned}"},"202":{"description":"Sent, still confirming: {burnTx, statusUrl}. Do not pay again."},"402":{"description":"Payment required: the exact price (PAYMENT-REQUIRED header + JSON body with quote)"}}},"post":{"summary":"Same as GET, with {from,to,amount,ref} in a JSON body","x-payment-info":{"protocols":["x402"],"scheme":"exact"},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","enum":["base","arc"]},"to":{"type":"string"},"amount":{"type":"string"},"ref":{"type":"string"}},"required":["to","amount"]}}}}}},"/v1/bridge/quote":{"get":{"summary":"Free quote, no payment","parameters":[{"name":"from","in":"query","required":false,"description":"Source chain: arc or base","schema":{"type":"string","example":"arc"}},{"name":"to","in":"query","required":true,"description":"Destination chain. Live routes: Arc -> Base, Base -> Arc","schema":{"type":"string","example":"base"}},{"name":"amount","in":"query","required":true,"description":"USDC to RECEIVE on the destination (minimum 1)","schema":{"type":"string","example":"1"}},{"name":"ref","in":"query","required":false,"description":"Optional referrer EVM address (earns 20% of Liquid's fee). Omit it unless you have one; an invalid value is ignored.","schema":{"type":"string"}}]}},"/v1/bridge/routes":{"get":{"summary":"Every destination with live price and whether it is open"}},"/v1/bridge/status/{burnTx}":{"get":{"summary":"Circle attestation and mint state for a bridge","parameters":[{"name":"burnTx","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/bridge/referrer/{payer}":{"get":{"summary":"A payer's sticky referrer","parameters":[{"name":"payer","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/bridge/earnings/{referrer}":{"get":{"summary":"A referrer's unclaimed earnings on each chain, and how to claim","parameters":[{"name":"referrer","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/bridge/guide":{"get":{"summary":"Plain-English guide: positioning, steps, referrals"}},"/v1/bridge/proof":{"get":{"summary":"Proof of delivery: every bridge with burn tx, mint tx, fee, and the incident record (HTML; JSON at /v1/bridge/deliveries)"}},"/v1/bridge/deliveries":{"get":{"summary":"Proof of delivery as JSON: every bridge, totals, incidents, contracts"}},"/v1/bridge/balances/{address}":{"get":{"summary":"Free: USDC and gas balance of an address on every CCTP chain (Ethereum, Base, Arbitrum, OP, Polygon, Avalanche, Unichain, Linea, Sonic, World Chain, Arc)","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","example":"0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90"}}]}},"/v1/bridge/cctp/{txHash}":{"get":{"summary":"Free: status of ANY Circle CCTP v2 transfer by burn tx: attestation, mint check on the destination, and how to finish a stuck one","parameters":[{"name":"txHash","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","example":"0x2aa8430c29f0c95b9664ceb4cad2a5ee11f8edfb471263281f63938566aa91ae"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","example":"arc"},"description":"Source chain if known"}]}},"/v1/bridge/x402/check":{"post":{"summary":"Free x402 debugger: decode a payment request (url or requirement) and optionally verify a signed payment, with the fix for every failed check","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","example":"https://api.liquidagent.ai/v1/signals"},"method":{"type":"string","enum":["GET","POST"]},"body":{"type":"object"},"requirement":{"type":"string","description":"PAYMENT-REQUIRED header value or 402 JSON body"},"payment":{"type":"string","description":"PAYMENT-SIGNATURE / X-PAYMENT header value to verify"}}}}}}}},"/v1/bridge/x402/ready":{"post":{"summary":"Free: can this wallet pay this x402 endpoint right now, and if not, the cheapest fix","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["address"],"properties":{"address":{"type":"string","example":"0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90"},"url":{"type":"string","example":"https://api.liquidagent.ai/v1/signals"},"method":{"type":"string","enum":["GET","POST"]},"body":{"type":"object"},"requirement":{"type":"string"}}}}}}}}}}