# DeFi Oracle Token Liquidity Lookup

> DeFi Oracle Token Liquidity Lookup is a paid API for AI agents from oraclius.vercel.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Returns liquidity pool data for a given token symbol, including total liquidity in USD, pool count, and pool details across chains

## Facts

- Endpoint: POST https://oraclius.vercel.app/api/token-liquidity
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-oracle-token-liquidity-lookup-9fc2e0d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4yjs8rf9T4-St2iYlEYOG

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 defi-oracle-token-liquidity-lookup-9fc2e0d2 -d '<json body>'
```

Example prompt: Can you check the on-chain liquidity for USDC on Ethereum — I want to see how many pools there are and the total liquidity in USD before I make a swap decision?

## When to prefer this

Use this endpoint when you need on-chain liquidity depth data for a specific token — especially useful before executing swaps to assess slippage risk, or when evaluating a token's DeFi ecosystem health by pool count and TVL. Prefer over generic price feeds when pool-level granularity matters.

## Known failure modes

- Unknown or unsupported token symbol returns empty pools array
- Invalid chain name may return no results or error
- Token with no DeFi pools returns zero pool_count and zero total_liquidity_usd
- Rate limiting or upstream DeFiLlama API downtime causes 5xx errors
- Payment failure via x402/USDC on Base blocks request before processing

## How this service works

DeFi data for AI agents — yield rates, swap routes, IL calculator, liquidation risk, MEV scanner, TVL tracking. Powered by DeFiLlama + on-chain RPC data. Pay with USDC on Base via x402.

## Output

Returns an object containing the token symbol, chain, total liquidity in USD, pool count, and an array of individual pool details sourced from DeFiLlama and on-chain RPC data

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "symbol"
 ],
 "properties": {
  "chain": {
   "type": "string"
  },
  "symbol": {
   "type": "string",
   "description": "Token symbol"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string"
  },
  "pools": {
   "type": "array"
  },
  "token": {
   "type": "string"
  },
  "pool_count": {
   "type": "number"
  },
  "total_liquidity_usd": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-oracle-token-liquidity-lookup-9fc2e0d2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from oraclius.vercel.app](https://www.zero.xyz/host/oraclius.vercel.app/llms.txt)