{"name":"Denaro Arc FX Scoring API","version":"0.1.0","description":"Pre-trade scoring service for cross-token FX swaps on Arc Testnet. Given a proposed swap, returns a quality score, a sub-component breakdown, and an execution-split recommendation that balances onchain liquidity against OTC fills for large orders.","audience":"automated agents and trading bots","network":{"chain":"Arc Testnet","caip2":"eip155:5042002"},"payments":{"protocol":"x402","schemes":["exact"],"extensions":["GatewayWalletBatched"],"asset":"USDC","facilitator":"Circle Gateway (testnet)","notes":"Paid endpoints respond 402 Payment Required with an x402 challenge in the PAYMENT-REQUIRED header. Both standard onchain settlement and gas-free Circle Gateway nanopayments are supported on Arc Testnet."},"endpoints":[{"method":"GET","path":"/","auth":"none","price":null,"description":"API discovery manifest. Use this to introspect available endpoints."},{"method":"GET","path":"/health","auth":"none","price":null,"description":"Liveness probe."},{"method":"POST","path":"/score_swap","auth":"x402","price":"$0.001","description":"Score a proposed swap and receive an execution-split recommendation across onchain and OTC venues.","request":{"contentType":"application/json","schema":{"tokenIn":"string. Symbol of the input token, e.g. \"USDC\".","tokenOut":"string. Symbol of the output token, e.g. \"EURC\".","amountIn":"string or number. Input amount in human units.","chain":"string. Chain identifier, e.g. \"Arc_Testnet\".","fromAddress":"0x-prefixed EVM address of the sender.","toAddress":"0x-prefixed EVM address of the recipient.","stopLimit":"{ amount: string, token: string }. Optional stop-limit floor.","estimatedOutput":"{ amount: string, token: string }. Quoted output for context.","fees":"Array of { token, amount, type } describing the fee breakdown."},"example":{"tokenIn":"USDC","tokenOut":"EURC","amountIn":"10000","chain":"Arc_Testnet","fromAddress":"0x031b22b28ff939ff65adfcae0eb42c0f103f3b40","toAddress":"0x031b22b28ff939ff65adfcae0eb42c0f103f3b40","stopLimit":{"amount":"7924.65261","token":"EURC"},"estimatedOutput":{"amount":"8169.744959","token":"EURC"},"fees":[{"token":"USDC","amount":"2.0","type":"provider"},{"token":"USDC","amount":"0.041792266752096","type":"gas"}]}},"response":{"contentType":"application/json","schema":{"score":"number. Overall score from 0 to 100.","rating":"one of \"excellent\", \"good\", \"fair\", \"poor\".","confidence":"number from 0 to 1.","components":"{ liquidity, priceImpact, routeQuality, latencyMs }. Sub-component scores.","recommendation":"string. Human-readable execution advice.","split":"{ onchain: { pctOfInput, amount, token, venue }, otc: { pctOfInput, amount, token, partner, partnerUrl, rationale } }.","input":"Echo of the request body.","paidBy":"0x address that settled the x402 payment.","network":"CAIP-2 network where the payment was settled."}}}],"contact":{"docs":"https://arc-fx.denaro.tech/"}}