{"uid":"cap_ooMvZSVcb_jB1L6h-8299","slug":"alphapipeline-dex-slippage-525302bd","name":"AlphaPipeline DEX Slippage","description":"GeckoTerminal-backed DEX pool liquidity and estimated trade slippage - size a trade or compare pools before swapping, with a clearly-flagged constant-product approximation model.","url":"https://alphapipeline-eu.onrender.com/v1/dex/liquidity-slippage","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},"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"},"estimated_slippage_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Estimated Slippage Pct","default":null}}}}}}},"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-09-14T18:30:42.170Z","isFirstParty":false}