{"uid":"cap_ooMvZSVcb_jB1L6h-8299","slug":"alphapipeline-dex-slippage-525302bd","name":"AlphaPipeline DEX Slippage","description":"GeckoTerminal-backed DEX pool liquidity and estimated trade slippage, plus fixed $1k/$5k/$10k slippage_tiers for at-a-glance depth checks - size a trade or compare pools before swapping, with a clearly-flagged constant-product approximation model. Paid in USDC on Base.","url":"https://alphapipeline-eu.onrender.com/v1/dex/liquidity-slippage?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["trade_size_usd"],"properties":{"network":{"type":"string","description":"GeckoTerminal network id, e.g. base, eth. Defaults to base."},"pool_address":{"type":"string","description":"Specific DEX pool contract address (optional if token_address is given)."},"token_address":{"type":"string","description":"Token contract address - the most liquid pool is auto-selected (optional if pool_address is given)."},"trade_size_usd":{"type":"number","description":"Hypothetical trade size in USD to estimate slippage for."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"DexSlippageResponse","required":["generated_at","network","trade_size_usd","price_impact_model","data_source"],"properties":{"notice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notice","default":null},"network":{"type":"string","title":"Network"},"pool_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pool Name","default":null},"data_source":{"type":"string","title":"Data Source"},"generated_at":{"type":"object","title":"TimestampPair","required":["utc","kst"],"properties":{"kst":{"type":"string","title":"Kst"},"utc":{"type":"string","title":"Utc"}}},"pool_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pool Address","default":null},"pool_fee_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pool Fee Pct","default":null,"description":"Swap fee tier of the selected pool (e.g. 0.05 for a 0.05% Uniswap v3 tier), parsed from pool_name. Disclosed for your own accounting only - NOT subtracted from estimated_slippage_pct or slippage_tiers."},"liquidity_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Liquidity Usd","default":null},"token_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token Address","default":null},"slippage_tiers":{"anyOf":[{"type":"array","items":{"type":"object","title":"SlippageTier","required":["trade_size_usd"],"properties":{"warning_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Warning Level","default":null,"description":"Heuristic risk label for this tier: LOW (<1% impact), MEDIUM (1-3%), or HIGH (>3%). This is AlphaPipeline's own threshold, not an industry standard."},"trade_size_usd":{"type":"number","title":"Trade Size Usd","description":"Fixed hypothetical trade size in USD for this tier ($1,000 / $5,000 / $10,000)."},"estimated_price_impact_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Estimated Price Impact Pct","default":null,"description":"Estimated price impact percentage at this trade size, using the same constant-product (x*y=k) 50:50 approximation as estimated_slippage_pct."}}}},{"type":"null"}],"title":"Slippage Tiers","default":null,"description":"Fixed $1,000/$5,000/$10,000 price-impact tiers computed from the same pool liquidity data, independent of the trade_size_usd query parameter - lets an agent gauge depth at a glance without multiple calls."},"trade_size_usd":{"type":"number","title":"Trade Size Usd"},"volume_24h_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Volume 24H Usd","default":null},"price_impact_model":{"type":"string","title":"Price Impact Model"},"quote_token_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Token Symbol","default":null,"description":"Parsed from GeckoTerminal's pool_name (e.g. 'USDC' from 'WETH / USDC 0.05%'). Null when the pool name doesn't match the expected 'BASE / QUOTE' format."},"assumed_gas_cost_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Assumed Gas Cost Usd","default":null,"description":"Flat per-swap gas cost estimate for this network (same table used by arb-spread-matrix), not a live on-chain gas quote."},"alternate_direct_pool":{"anyOf":[{"type":"object","title":"AlternateDirectPool","properties":{"pool_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pool Name","default":null},"pool_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pool Address","default":null,"description":"The alternate pool's contract address."},"liquidity_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Liquidity Usd","default":null},"quote_token_symbol":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Token Symbol","default":null}}},{"type":"null"}],"default":null,"description":"Only populated when quote_token_is_stablecoin is false/null AND a stablecoin-quoted pool exists elsewhere for this token - gives that pool's address/name/liquidity so you can re-query this endpoint with that pool_address instead of assuming a multi-hop route is required."},"estimated_slippage_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Estimated Slippage Pct","default":null},"quote_token_is_stablecoin":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Quote Token Is Stablecoin","default":null,"description":"Whether quote_token_symbol is a known USD stablecoin (USDC/USDbC/USDT/DAI/etc.). If false or null, this pool does not quote directly against USD - converting the output to USD requires an additional hop/swap that this estimate does not account for. This endpoint always picks the single most-liquid pool for a token, which is not guaranteed to be USD-quoted."},"direct_stablecoin_pool_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Direct Stablecoin Pool Exists","default":null,"description":"Whether ANY pool for this token (not just the single most-liquid one selected above) is quoted directly against a USD stablecoin. Null when you passed pool_address directly instead of token_address - the full pool list for the token was never fetched, so this can't be checked."}}}}}}},"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_nn73teh2s36YM5YI1Baeq","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":"Estimates trade slippage and retrieves pool liquidity data for a given DEX pool on a specified network using GeckoTerminal data, based on a constant-product approximation model.","exampleAgentPrompt":"Before I swap, can you check what the estimated slippage would be on a $5,000 trade for the token at 0x4200000000000000000000000000000000000006 on the Base network?","exampleUseCases":[{"title":"Pre-swap slippage check for large trade","prompt":"I'm about to swap $25,000 worth of tokens on Base — can you estimate the slippage for pool address 0xd0b53D9277642d899DF5C87A3966A349A798F224 before I go through with it?"},{"title":"Find most liquid pool for a token","prompt":"I want to swap some WETH on Ethereum, can you look up the most liquid pool for token 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 and tell me what slippage I'd expect on a $1,000 trade?"},{"title":"Compare slippage before routing a DeFi swap","prompt":"Help me figure out the price impact if I try to swap $10,000 on the Base network — use token address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 and auto-pick the best pool."}],"resultDescription":"Returns the estimated slippage percentage and pool liquidity details including pool name, pool address, liquidity in USD, 24-hour trading volume, trade size used for estimation, the price impact model used (constant-product approximation, clearly flagged), data source attribution, and generation timestamps in UTC and KST.","failureModes":["Invalid or unsupported network ID returns an error","Pool address not found on specified network","Neither pool_address nor token_address provided returns a validation error","Token with no liquid pools on the specified network returns null liquidity fields","GeckoTerminal data unavailable or rate-limited causes upstream failure","trade_size_usd missing triggers required field validation error"],"whenToPreferThis":"Use this endpoint when you need a quick pre-trade slippage estimate for a DEX swap on Base or Ethereum without executing any transaction. It is ideal for agents doing trade routing, size optimization, or pool comparison before committing to a swap. Prefer this over on-chain simulation when you need a fast, low-cost approximation and can accept the constant-product model caveat. Not suited for real-time execution or for pools with complex AMM curves (e.g. Curve or concentrated liquidity).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T18:34:45.278Z","isFirstParty":false,"canonicalSlug":"alphapipeline-dex-slippage-525302bd"}