# BaseDue Token Liquidity & Exit Analysis

> BaseDue Token Liquidity & Exit Analysis is a paid API for AI agents from api.firstmention.uk, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29).

Analyzes the on-chain liquidity depth and exit capacity for ERC-20 tokens on Base, estimating how much USD you can exit at given price impact thresholds across DEX venues like Aerodrome and Uniswap.

## Facts

- Endpoint: GET https://api.firstmention.uk/s/basedue/due?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/basedue-token-liquidity-exit-analysis-fde37c57
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UWud5P2tZWwNDR_3kGjgJ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability basedue-token-liquidity-exit-analysis-fde37c57
```

Example prompt: Can you check how much liquidity there is to exit a $5,000 position in cbBTC (0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf) on Base, with a max acceptable price impact of 1%?

## When to prefer this

Use this endpoint when you need to assess on-chain liquidity and exit capacity for a specific ERC-20 token on the Base network before executing a trade. It is ideal for pre-trade risk analysis, portfolio rebalancing decisions, and determining which DEX venue offers the deepest liquidity. Prefer this over generic price APIs when you need slippage-aware exit estimates rather than just spot prices.

## Known failure modes

- Invalid or non-ERC-20 token address returns an error
- Token with no liquidity on Base DEXes may return ok:false with zero depth
- Requested exit size exceeding available liquidity returns ok:false with actual achievable amount
- Missing required 'token' query parameter causes request failure
- Price impact exceeds requested maximum, resulting in ok:false for the size sub-result

## How this service works

Pay-per-call HTTP APIs, paid with x402 in USDC on Base (eip155:8453): agentkit, api-change-check, basedue, basewatch, chainread, check-sanctions, chgwatch, company-facts, composite, edgar, feednews, pageaudit, solcheck, token-dd, txpreflight, walletcheck, webmd, webread, websearch, x402index. Each operation describes its service.

## Output

Returns a JSON object with per-token results including: the best pool and venue for exit, maximum USD that can be exited within the price impact limit, spot price in USD, quote depth, token reserves, slippage percent and USD, and an overall verdict/grade for liquidity depth. Also includes a note that Uniswap V3 is excluded and figures are lower-bound estimates using a constant-product model.

## Request schema (JSON Schema)

```json
{
 "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"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "token"
     ],
     "properties": {
      "size": {
       "type": "number",
       "description": "/exit only: USD position size"
      },
      "token": {
       "type": "string",
       "description": "ERC-20 token address on Base (0x + 40 hex)"
      },
      "impact": {
       "type": "number",
       "description": "/exit only: max acceptable price impact percent (default 1)"
      },
      "tokens": {
       "type": "string",
       "description": "up to 3 comma-separated token addresses"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "ok": {
       "type": "boolean"
      },
      "chain": {
       "type": "string"
      },
      "summary": {
       "type": "object",
       "properties": {
        "poolCount": {
         "type": "number"
        },
        "bestDepthUsd": {
         "type": "number"
        },
        "bestDepthGrade": {
         "type": "string"
        }
       }
      },
      "verdict": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "note": "Capacity is a LOWER BOUND: Uniswap V3 pools are excluded from the size model. Constant-product model; comparable in order of magnitude, not exact.",
  "chain": "base",
  "ethUsd": 2343.51,
  "results": [
   {
    "ok": true,
    "best": {
     "pool": "0x2578365b3dfa7ffe60108e181efb79feddec2319",
     "venue": "aerodrome",
     "maxUsdOut": 3230.39,
     "quoteAsset": "WETH",
     "maxTokenSell": 0.040595
    },
    "size": {
     "ok": false,
     "pool": "0x2578365b3dfa7ffe60108e181efb79feddec2319",
     "venue": "aerodrome",
     "usdOut": 4923.79,
     "impactPct": 1.5242,
     "slippagePct": 1.524,
     "slippageUsd": 76.21,
     "requestedUsd": 5000
    },
    "token": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
    "symbol": "cbBTC",
    "venues": [
     {
      "pool": "0x2578365b3dfa7ffe60108e181efb79feddec2319",
      "venue": "aerodrome",
      "maxUsdOut": 3230.39,
      "quoteAsset": "WETH",
      "maxTokenSell": 0.040595,
      "spotPriceUsd": 80380.2,
      "quoteDepthUsd": 324023.6,
      "tokenReserveUi": 4.029
     }
    ],
    "impactLimitPct": 1
   }
  ],
  "endpoint": "exit"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/basedue-token-liquidity-exit-analysis-fde37c57/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.firstmention.uk](https://www.zero.xyz/host/api.firstmention.uk/llms.txt)