{"uid":"cap_Jd4uNIFvuL5D656Xn2GGL","slug":"plexa-v1-quote-on-chain-swap-quote-with-price-impact-route-f9ec7609","name":"Plexa /v1/quote — On-Chain Swap Quote with Price Impact & Route","description":"Plexa /v1/quote — executable swap quote: the realizable fill price at your trade size, not a mid/spot price feed. Returns price impact (bps), worst-case slippage, depth and the per-leg route across Base/Polygon/Arbitrum liquidity, from canonical on-chain quoters. Call it before a swap to see what the fill actually costs. Informational data, not financial advice.","url":"https://api.getplexa.com/v1/quote","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["base","polygon","matic","arbitrum","arbitrum-one","arb","eip155:8453","eip155:137","eip155:42161"],"type":"string","description":"Optional, default \"base\". One of: base | polygon | matic | arbitrum | arbitrum-one | arb | eip155:8453 | eip155:137 | eip155:42161 — case-sensitive (see `enum`). This is the chain the QUOTE is computed on; the networks you may PAY on (including Solana) are a separate list in `accepts[]`."},"sizeIn":{"type":"string","pattern":"^(?:0\\.\\d*[1-9]\\d*|[1-9]\\d*(?:\\.\\d+)?)$","maxLength":78,"description":"Trade size as a human amount of tokenIn, e.g. \"1.5\" for 1.5 WETH. A STRING, not a number. At least one of sizeIn / sizeUSD is required; if BOTH are sent, sizeUSD wins and sizeIn is ignored."},"sizeUSD":{"type":"string","pattern":"^(?:0\\.\\d*[1-9]\\d*|[1-9]\\d*(?:\\.\\d+)?)$","maxLength":78,"description":"Trade size as a USD notional, e.g. \"5000\". A STRING, not a number; positive, no thousands separator (\"5,000\" is rejected) and no exponent (\"5e3\" is rejected) — see `pattern`. At least one of sizeIn / sizeUSD is required; if BOTH are sent, sizeUSD wins."},"tokenIn":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 being SOLD. 0x + 40 hex (see `pattern`) — a symbol like \"USDC\" is rejected with 400."},"tokenOut":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 being BOUGHT. 0x + 40 hex (see `pattern`) — a symbol like \"WETH\" is rejected with 400."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RZS-hAh9-9MjZp3aRnO_s","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the realizable fill price, price impact (bps), depth, routing, and worst-case slippage for a token swap on Base, Polygon, or Arbitrum using canonical on-chain quoters.","exampleAgentPrompt":"What's the realizable fill price and price impact if I swap $5000 USDC for WETH on Arbitrum right now — including the route and worst-case slippage?","exampleUseCases":[{"title":"Pre-trade analysis for large swaps","prompt":"Before I execute a big trade, check the realizable fill price and slippage for swapping 50 MATIC to USDC on Polygon — I need to know if the price impact is acceptable."},{"title":"Compare execution quality across chains","prompt":"I want to swap ETH for USDT but I'm not sure which chain to use. Get me quotes on Base, Polygon, and Arbitrum so I can see which one gives me the best fill price and lowest slippage for a $10,000 trade."},{"title":"Assess liquidity depth for positioning","prompt":"How deep is the liquidity pool for trading WBTC to ETH on Arbitrum? I'm considering a large position and need to understand if there's enough depth to avoid excessive price impact."}],"resultDescription":"Returns the actual executable fill price for the swap (not mid/spot), price impact in basis points, available liquidity depth, the per-leg DEX routing path, worst-case slippage estimate, and a confidence score. All derived from canonical on-chain quoters for the specified chain.","failureModes":["Invalid or unsupported token address returns an error","Both sizeIn and sizeUSD provided simultaneously causes a validation error","Neither sizeIn nor sizeUSD provided causes a validation error","Unsupported chain identifier returns an error","Insufficient on-chain liquidity may result in low confidence or no quote","Payment failure (x402) results in 402 status before quote is returned"],"whenToPreferThis":"Use this endpoint when you need the actual realizable fill price for a swap — accounting for price impact, depth, and slippage — rather than a mid-price or spot feed. Ideal for pre-trade analysis, trade sizing decisions, or comparing execution quality across Base, Polygon, and Arbitrum before submitting a transaction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:31:44.188Z","isFirstParty":false}