# Token Liquidity Relative Change — Benchmark Correlation

> Token Liquidity Relative Change — Benchmark Correlation is a paid API for AI agents from market.datapackvibe.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-16).

Computes the Pearson (or similar) correlation between token liquidity relative changes and a set of caller-supplied benchmark values, returning a deterministic bounded report.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-token-liquidity-change-correlation?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-liquidity-relative-change-benchmark-correlation-79375fb8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mWfo1gbi4O_E3HuL14Cpk

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 token-liquidity-relative-change-benchmark-correlation-79375fb8 -d '<json body>'
```

Example prompt: I have liquidity readings for a token over 4 periods — the current values are 120000, 132000, 120000, and 132000, with previous values of 100000, 110000, 100000, and 110000 — and I want to know how correlated those relative liquidity changes are against the benchmarks 10, 20, 30, and 40.

## When to prefer this

Choose this endpoint when you need a fast, cheap ($0.01 USDC), deterministic correlation computation between token liquidity relative changes and a set of reference benchmarks — particularly in automated quant pipelines, DeFi analytics dashboards, or token monitoring workflows where you already have the liquidity snapshots and benchmark series and just need the correlation number without building the math yourself.

## Known failure modes

- Fewer than 2 rows or benchmark values provided — minimum 2 required for each array
- Mismatched array lengths between rows and benchmarks may produce degenerate correlation
- Zero or negative liquidity values rejected — exclusiveMinimum: 0 enforced
- Exceeding 200 items in rows or benchmarks array returns validation error
- Non-numeric benchmark values cause schema rejection
- Payment of 0.01 USDC not processed — 402 Payment Required response

## How this service works

Token liquidity relative change — Benchmark correlation: Benchmark correlation for Token liquidity relative change. Supplied token observations only. Deterministic calculation or caller-threshold verdict, not a live scan, safety proof or trade recommendation. Specialised preset in a shared 50-profile, 20-operation engine. 0.01 USDC includes one bounded benchmark correlation report.

## Output

Returns a bounded benchmark correlation report showing the computed correlation coefficient(s) between the series of token liquidity relative changes (derived from current vs previous liquidity pairs) and the supplied benchmark values. The result is deterministic for a given set of inputs and does not represent a live market scan, safety guarantee, or trade recommendation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "current_liquidity",
     "previous_liquidity"
    ],
    "properties": {
     "current_liquidity": {
      "type": "number",
      "default": 120000,
      "maximum": 10000000000000000,
      "minimum": 0,
      "exclusiveMinimum": 0
     },
     "previous_liquidity": {
      "type": "number",
      "default": 100000,
      "maximum": 10000000000000000,
      "minimum": 0,
      "exclusiveMinimum": 0
     }
    },
    "additionalProperties": false
   },
   "default": [
    {
     "current_liquidity": 120000,
     "previous_liquidity": 100000
    },
    {
     "current_liquidity": 132000,
     "previous_liquidity": 110000.00000000001
    },
    {
     "current_liquidity": 120000,
     "previous_liquidity": 100000
    },
    {
     "current_liquidity": 132000,
     "previous_liquidity": 110000.00000000001
    }
   ],
   "maxItems": 200,
   "minItems": 2
  },
  "benchmarks": {
   "type": "array",
   "items": {
    "type": "number",
    "default": 1,
    "maximum": 1000000000000000000,
    "minimum": -1000000000000000000
   },
   "default": [
    10,
    20,
    30,
    40
   ],
   "maxItems": 200,
   "minItems": 2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-liquidity-relative-change-benchmark-correlation-79375fb8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from market.datapackvibe.com](https://www.zero.xyz/host/market.datapackvibe.com/llms.txt)