# x402 Token Liquidity Pulse

> x402 Token Liquidity Pulse is a paid API for AI agents from agent-economy-signal-x402-mainnet.bronzetti-andrea.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns real-time liquidity status, best market price, 24h volume, and a next-action recommendation for a given token symbol or contract address on Base mainnet, gated by a $0.005 USDC micropayment.

## Facts

- Endpoint: GET https://agent-economy-signal-x402-mainnet.bronzetti-andrea.workers.dev/premium/token-liquidity-pulse
- 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/x402-token-liquidity-pulse-2322f722
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_deLK3Xuqe7FAHpmKUsAhG

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 x402-token-liquidity-pulse-2322f722
```

Example prompt: Check whether BRETT has enough liquidity to trade right now on Base — I need the best market price, 24h volume, and a recommendation on whether to proceed.

## When to prefer this

Use this endpoint when an AI agent needs a fast, pay-per-request, machine-readable liquidity signal for a Base-chain token before executing a trade or DeFi operation. It is ideal for autonomous agents that need deterministic go/no-go signals without maintaining their own market data infrastructure. Prefer this over general DEX APIs when you need a pre-packaged next-action recommendation and are already operating within the x402 micropayment ecosystem on Base.

## Known failure modes

- Payment not included or invalid — 402 response requiring x402 USDC micropayment on Base
- Unknown or unrecognized token symbol — empty or error result
- Token exists but has no liquidity data — status may return ILLIQUID or error
- Contract address malformed — query rejected
- Stale data if called near the 300-second validity boundary
- Worker downtime or upstream data provider outage — 5xx response

## How this service works

Machine-readable pay-per-request intelligence for autonomous agents on Base mainnet. x402 v2 resources expose deterministic decisions, market demand signals, payment preflight checks, repository intelligence, crypto catalysts, OpenAPI integration analysis and token liquidity signals.

## Output

A JSON object containing: the query token, a liquidity status label (e.g. LIQUID), the best market chain and price in USD, total liquidity in USD, 24h trading volume in USD, a machine-readable next-action string (e.g. MARKET_IS_LIQUID_ENOUGH_FOR_FURTHER_ANALYSIS), and a validity window in seconds (typically 300s). Priced at $0.005 USDC per call via x402.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "description": "Token symbol or contract address."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "BRETT",
  "status": "LIQUID",
  "product": "Token Liquidity Pulse",
  "version": "1.0.0",
  "price_usd": 0.005,
  "best_market": {
   "chain": "base",
   "price_usd": 0.12,
   "liquidity_usd": 250000,
   "volume_24h_usd": 900000
  },
  "next_action": "MARKET_IS_LIQUID_ENOUGH_FOR_FURTHER_ANALYSIS",
  "valid_for_seconds": 300
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-token-liquidity-pulse-2322f722/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-economy-signal-x402-mainnet.bronzetti-andrea.workers.dev](https://www.zero.xyz/host/agent-economy-signal-x402-mainnet.bronzetti-andrea.workers.dev/llms.txt)