Utilities · x402 · early usage

GeckoTerminal-backed DEX pool liquidity and estimated trade slippage, plus fixed $1k/$5…

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 USD…

by alphapipeline-eu.onrender.com · discovered, not yet claimed by its owner · updated 2026-10-01

30d calls1

30d payers1

MethodGET

Outputjson

Mirrored from Coinbase's public x402 Bazaar. The description is the provider's own text and has not been reviewed here; the payment requirements are copied as published.

What it does

Tags: crypto · dex · liquidity · slippage · bazaar

Call contract

Method: GET
Input: query parameters
Output: json
Last paid call: 2026-10-01

Input example from Bazaar metadata

{
  "network": "base",
  "token_address": "0x4200000000000000000000000000000000000006",
  "trade_size_usd": 10000
}

Output example

{
  "assumed_gas_cost_usd": 0.05,
  "data_source": "geckoterminal",
  "estimated_slippage_pct": 0.08,
  "generated_at": {
    "kst": "2026-09-04 21:00:00 KST",
    "utc": "2026-09-04T12:00:00Z"
  },
  "liquidity_usd": 25000000,
  "network": "base",
  "notice": "Slippage is an approximation computed only from the pool's aggregate USD liquidity as reported by GeckoTerminal - it assumes the pool is a standard constant-product (x*y=k) AMM with the two tokens in a 50:50 ratio. Actual slippage can differ significantly for Uniswap v3-style concentrated-liquidity pools or stableswap pools - always re-verify with an on-chain quote before trading. slippage_tiers uses the same approximation at three fixed sizes regardless of the trade_size_usd you passed in; warning_level thresholds (LOW <1%, MEDIUM 1-3%, HIGH >3%) are AlphaPipeline's own heuristic, not an industry standard. assumed_gas_cost_usd is a flat per-swap estimate, not a live gas quote. quote_token_is_stablecoin tells you whether this pool's quote side is a USD stablecoin - if false or null, converting to USD requires an additional hop this estimate does not account for.",
  "pool_address": "0xd0b53d9277642d899df5c87a3966a349a798f224",
  "pool_fee_pct": 0.05,
  "pool_name": "WETH / USDC 0.05%",
  "price_impact_model": "constant_product_50_50_approximation",
  "quote_token_is_stablecoin": true,
  "quote_token_symbol": "USDC",
  "slippage_tiers": [
    {
      "estimated_price_impact_pct": 0.008,
      "trade_size_usd": 1000,
      "warning_level": "LOW"
    },
    {
      "estimated_price_impact_pct": 0.04,
      "trade_size_usd": 5000,
      "warning_level": "LOW"
    },
    {
      "estimated_price_impact_pct": 0.08,
      "trade_size_usd": 10000,
      "warning_level": "LOW"
    }
  ],
  "token_address": null,
  "trade_size_usd": 10000,
  "volume_24h_usd": 8500000
}

Use with an agent

Discover. Agents find this listing with GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP tool search_resources, or /discovery/resources.
Inspect. Fetch /resources/30140.json for the price and payment options.
Pay. Call GET https://alphapipeline-eu.onrender.com/v1/dex/liquidity-slippage. The provider answers 402 with its payment requirements. An x402 client signs one of the options below and retries with PAYMENT-SIGNATURE.
Execute. The provider returns 200 with the data. Agent Bazaar is not in the request path and never sees your payment.

For humans

You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.

Pricing & payment

Price: $0.02 / request
Protocol: x402 v2
Auth: No account or API key. Pay per request.
Networks: Base
Demand: 1 calls · 1 unique payers in 30d (public x402 Bazaar data)

x402 payment requirements

Scheme	Network	Asset	Amount	Pay to	Timeout
exact	Base eip155:8453	USDC	$0.02	0x2bcfA4F7E1fA5E96934846A7dEa623398Ed7f752	300s

accepts[] (raw JSON)

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x2bcfA4F7E1fA5E96934846A7dEa623398Ed7f752",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "20000",
    "amountUsd": 0.02,
    "maxTimeoutSeconds": 300
  }
]

Schemas

Output schema (JSON Schema)

{
  "properties": {
    "example": {
      "properties": {
        "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"
        },
        "data_source": {
          "title": "Data Source",
          "type": "string"
        },
        "estimated_slippage_pct": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Estimated Slippage Pct"
        },
        "generated_at": {
          "properties": {
            "kst": {
              "title": "Kst",
              "type": "string"
            },
            "utc": {
              "title": "Utc",
              "type": "string"
            }
          },
          "required": [
            "utc",
            "kst"
          ],
          "title": "TimestampPair",
          "type": "object"
        },
        "liquidity_usd": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Liquidity Usd"
        },
        "network": {
          "title": "Network",
          "type": "string"
        },
        "notice": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Notice"
        },
        "pool_address": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Pool Address"
        },
        "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"
        },
        "pool_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Pool Name"
        },
        "price_impact_model": {
          "title": "Price Impact Model",
          "type": "string"
        },
        "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"
        },
        "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"
        },
        "slippage_tiers": {
          "anyOf": [
            {
              "items": {
                "properties": {
                  "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"
                  },
                  "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"
                  },
                  "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"
        },
        "token_address": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Token Address"
        },
        "trade_size_usd": {
          "title": "Trade Size Usd",
          "type": "number"
        },
        "volume_24h_usd": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Volume 24H Usd"
        }
      },
      "required": [
        "generated_at",
        "network",
        "trade_size_usd",
        "price_impact_model",
        "data_source"
      ],
      "title": "DexSlippageResponse",
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Example shape — generated from the schema, not a captured live response

{
  "example": {
    "assumed_gas_cost_usd": null,
    "data_source": "string",
    "estimated_slippage_pct": null,
    "generated_at": {
      "kst": "string",
      "utc": "string"
    },
    "liquidity_usd": null,
    "network": "string",
    "notice": null,
    "pool_address": null,
    "pool_fee_pct": null,
    "pool_name": null,
    "price_impact_model": "string",
    "quote_token_is_stablecoin": null,
    "quote_token_symbol": null,
    "slippage_tiers": null,
    "token_address": null,
    "trade_size_usd": 0,
    "volume_24h_usd": null
  },
  "type": "string"
}

Examples

curl

curl -X GET 'https://alphapipeline-eu.onrender.com/v1/dex/liquidity-slippage'
# -> 402 Payment Required; read PAYMENT-REQUIRED
# retry the identical request with PAYMENT-SIGNATURE

JavaScript

const res = await fetch("https://alphapipeline-eu.onrender.com/v1/dex/liquidity-slippage", {
  "method": "GET"
});
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

Python

import httpx
res = httpx.request("GET", "https://alphapipeline-eu.onrender.com/v1/dex/liquidity-slippage")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header

Details

Provider: alphapipeline-eu.onrender.com
Endpoint: https://alphapipeline-eu.onrender.com/v1/dex/liquidity-slippage
Machine-readable: /resources/30140.json