# AgentDiet Token Liquidity Lookup

> AgentDiet Token Liquidity Lookup is a paid API for AI agents from rag-diet.agentdiet.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-22).

Retrieves token liquidity data from the AgentDiet RAG context distillation node, returning compression and liquidity metrics.

## Facts

- Endpoint: GET https://rag-diet.agentdiet.dev/v1/token-liquidity?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentdiet-token-liquidity-lookup-1db735ee
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EkxXSOr62Mzp7bQClAtDs

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 agentdiet-token-liquidity-lookup-1db735ee
```

Example prompt: Can you check the token liquidity data for the USDC token on AgentDiet's RAG diet node and show me the compression ratio proof?

## When to prefer this

Use this endpoint when you need to verify token liquidity stats or compression efficiency metrics from the AgentDiet RAG distillation node specifically, especially in A2A or MCP pipeline contexts where you want proof-of-compression (ROI proof) alongside liquidity data, and you are willing to pay $0.01 USDC per call settled on Base.

## Known failure modes

- Invalid or missing token parameter returns error or empty data
- Payment not settled in USDC on Base causes 402 rejection
- Malformed input type or method enum mismatch causes schema validation error
- Node temporarily unavailable returns non-200 status

## How this service works

Deterministic B2A/A2A/MCP/x402/MPP/L402 execution and intelligence node at https://rag-diet.agentdiet.dev settling in USDC on Base.

## Output

Returns a JSON object with a 'data' payload, a 'status' field (e.g. 'ok'), and an 'roi_proof' object containing a 'compression_ratio_pct' value (e.g. 91.4) indicating how much the context was compressed.

## 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",
      "POST"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "token": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "status": "ok",
  "roi_proof": {
   "compression_ratio_pct": 91.4
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentdiet-token-liquidity-lookup-1db735ee/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from rag-diet.agentdiet.dev](https://www.zero.xyz/host/rag-diet.agentdiet.dev/llms.txt)
