Api Endpoint

AlphaPipeline DEX Slippage

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. Also flags whether a direct USD-stablecoin pool exists for the token, so you know before swapping if a multi-hop route would be needed. Paid in USDC on Base.

Open interactive test console

Offering

Provider
alphapipeline-eu.onrender.com
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Blockchain And Crypto
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://alphapipeline-eu.onrender.com/v1/dex/liquidity-slippage
MIME type
application/json
First seen
2026-10-16T01:50:14.534Z
Last seen
Tags
Crypto, DEX, Liquidity, slippage

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.02 USDC
Atomic price: 20000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "20000",
    "payTo": "0x2bcfA4F7E1fA5E96934846A7dEa623398Ed7f752"
  }
]

Observed health

Status
Healthy
Latest latency
154 ms
Average latency
1134 ms
HTTP status
402
Last checked
Reachability
100% over 12 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "HEAD",
        "DELETE"
      ]
    },
    "queryParams": {
      "type": "object",
      "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."
        }
      },
      "required": [
        "trade_size_usd"
      ]
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "example": {
      "type": "object",
      "properties": {
        "generated_at": {
          "properties": {
            "utc": {
              "title": "Utc",
              "type": "string"
            },
            "kst": {
              "title": "Kst",
              "type": "string"
            }
          },
          "required": [
            "utc",
            "kst"
          ],
          "title": "TimestampPair",
          "type": "object"
        },
        "network": {
          "title": "Network",
          "type": "string"
        },
        "pool_address": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Pool Address"
        },
        "token_address": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Token Address"
        },
        "pool_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Pool Name"
        },
        "liquidity_usd": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Liquidity Usd"
        },
        "volume_24h_usd": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Volume 24H Usd"
        },
        "trade_size_usd": {
          "title": "Trade Size Usd",
          "type": "number"
        },
        "estimated_slippage_pct": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Estimated Slippage Pct"
        },
        "price_impact_model": {
          "title": "Price Impact Model",
          "type": "string"
        },
        "slippage_tiers": {
          "anyOf": [
            {
              "items": {
                "properties": {
                  "trade_size_usd": {
                    "description": "Fixed hypothetical trade size in USD for this tier ($1,000 / $5,000 / $10,000).",
                    "title": "Trade Size Usd",
                    "type": "number"
                  },
                  "estimated_price_impact_pct": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "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.",
                    "title": "Estimated Price Impact Pct"
                  },
                  "warning_level": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "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.",
                    "title": "Warning Level"
                  }
                },
                "required": [
                  "trade_size_usd"
                ],
                "title": "SlippageTier",
                "type": "object"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "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.",
          "title": "Slippage Tiers"
        },
        "quote_token_symbol": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "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.",
          "title": "Quote Token Symbol"
        },
        "quote_token_is_stablecoin": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "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.",
          "title": "Quote Token Is Stablecoin"
        },
        "pool_fee_pct": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "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.",
          "title": "Pool Fee Pct"
        },
        "assumed_gas_cost_usd": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "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.",
          "title": "Assumed Gas Cost Usd"
        },
        "direct_stablecoin_pool_exists": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "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.",
          "title": "Direct Stablecoin Pool Exists"
        },
        "alternate_direct_pool": {
          "anyOf": [
            {
              "properties": {
                "pool_address": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "The alternate pool's contract address.",
                  "title": "Pool Address"
                },
                "pool_name": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "title": "Pool Name"
                },
                "liquidity_usd": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "title": "Liquidity Usd"
                },
                "quote_token_symbol": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "title": "Quote Token Symbol"
                }
              },
              "title": "AlternateDirectPool",
              "type": "object"
            },
            {
              "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."
        },
        "data_source": {
          "title": "Data Source",
          "type": "string"
        },
        "notice": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Notice"
        }
      },
      "required": [
        "generated_at",
        "network",
        "trade_size_usd",
        "price_impact_model",
        "data_source"
      ],
      "title": "DexSlippageResponse"
    }
  },
  "required": [
    "type"
  ]
}