# DeFi Oracle Token Liquidity Lookup

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

Returns liquidity pool data for a given token symbol, including total USD liquidity, pool count, and individual pool details across DeFi protocols.

## Facts

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

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-abd996af -d '<json body>'
```

Example prompt: Can you check the liquidity pools for WETH on Base — I want to know how many pools exist and what the total liquidity in USD looks like before I plan a large swap?

## When to prefer this

Use this endpoint when you need to assess token liquidity depth across DeFi pools before executing swaps, routing trades, or evaluating market risk. It is particularly valuable for agents doing pre-trade due diligence, TVL monitoring, or liquidity-aware routing decisions. Prefer this over generic price feeds when pool-level granularity (pool count, per-pool breakdown) matters.

## Known failure modes

- Unknown or unsupported token symbol returns empty pools array or error
- Chain parameter mismatch results in no matching pools found
- DeFiLlama data unavailable or stale during outage windows
- Very new or obscure tokens may have zero indexed pools
- Missing required 'symbol' field returns a validation error

## 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 a JSON 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-abd996af/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aracil.vercel.app](https://www.zero.xyz/host/aracil.vercel.app/llms.txt)