# OnchainPulse DEX Liquidity Snapshot

> OnchainPulse DEX Liquidity Snapshot is a paid API for AI agents from onchainpulse.theaslangroupllc.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns a live DEX liquidity and momentum snapshot for any EVM token, including USD liquidity, price, market cap, pair age, 1h/24h volume, buy/sell ratio, and price change — sourced directly from DexScreener.

## Facts

- Endpoint: GET https://onchainpulse.theaslangroupllc.com/api/facet/liquidity
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/onchainpulse-dex-liquidity-snapshot-ceed2052
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_b5sN_EAfeQGjZjCizuxWR

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 onchainpulse-dex-liquidity-snapshot-ceed2052
```

Example prompt: Before I buy this token — contract address 0xabc123... on Base — can you pull a live DEX liquidity snapshot showing the current price, market cap, total liquidity in USD, buy vs sell ratio, and how the price has moved in the last 24 hours?

## When to prefer this

Choose this endpoint when you need a cheap ($0.005), fast, raw DexScreener liquidity read for a single EVM token on supported chains — ideal as a pre-trade depth check before committing capital. Prefer this over /api/evmtoken ($0.015) when you only need market data and do not need the fused safety/honeypot verdict. Use /api/exit-depth instead if you specifically need sell-impact modeling for large exits.

## Known failure modes

- Token address not found on the specified chain — returns empty or error response
- Token exists but has no active DEX pair — liquidity data unavailable
- Unsupported chain provided — only Base, Ethereum, BSC, Arbitrum, Polygon, Optimism, Avalanche are supported
- DexScreener upstream outage — stale or missing data
- Malformed token address — request validation error
- Very new token with insufficient trading history — pair age and volume fields may be zero or null

## How this service works

Token liquidity and momentum snapshot, half a cent: live DEX liquidity in USD, price, market cap, pair age, 1h/24h volume, buy-vs-sell transaction ratio, price change — the raw DexScreener read for any EVM token, one source, no fusion. Base, Ethereum, BSC, Arbitrum, Polygon, Optimism, Avalanche. Cheapest pre-trade depth check; upgrade to /api/evmtoken ($0.015) for the fused safety verdict or /api/exit-depth for sell-impact modeling.

## Output

Returns a real-time snapshot of DEX market data for the requested EVM token, including: live USD liquidity depth, current token price, market cap, trading pair age, 1-hour and 24-hour volume, buy-to-sell transaction count ratio, and recent price change percentage — all sourced from DexScreener with no data fusion or safety scoring applied.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "address"
 ],
 "properties": {
  "chain": {
   "type": "string",
   "description": "EVM chain (default base) — base, ethereum, bsc, arbitrum, polygon, optimism, avalanche"
  },
  "address": {
   "type": "string",
   "description": "ERC-20 token contract address (0x + 40 hex)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "dex": "uniswap",
  "chain": "base",
  "source": "dexscreener",
  "volume": {
   "h1": 310000,
   "h24": 6100000
  },
  "address": "0x532f27101965dd16442E59d40670FaF5eBB142E4",
  "txns_h1": {
   "buys": 420,
   "sells": 318
  },
  "upgrade": {
   "full_scan": "/api/evmtoken — $0.015 fused safety verdict",
   "exit_depth": "/api/exit-depth — sell-impact modeling"
  },
  "pair_url": "https://dexscreener.com/base/0x…",
  "price_usd": 0.0842,
  "market_cap": 812000000,
  "pair_found": true,
  "price_change": {
   "h1": 2.1,
   "h24": -1.4
  },
  "liquidity_usd": 4200000,
  "pair_age_hours": 9600,
  "buy_sell_ratio_h1": 1.32
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/onchainpulse-dex-liquidity-snapshot-ceed2052/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from onchainpulse.theaslangroupllc.com](https://www.zero.xyz/host/onchainpulse.theaslangroupllc.com/llms.txt)