# x402-factory Liquidity Summary

> x402-factory Liquidity Summary is a paid API for AI agents from x402-factory.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-14).

Returns execution-quality liquidity analytics for a prediction market — per-venue depth, spread in cents, and a 24-hour hourly volume profile, with optional slippage estimate.

## Facts

- Endpoint: GET https://x402-factory.com/v1/liquidity/:slug
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-factory-liquidity-summary-358c5ab3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0fV_LKJDdCkCe7fYikblS

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-factory-liquidity-summary-358c5ab3
```

Example prompt: Can you pull the liquidity summary for the 'us-election-2024' prediction market and estimate slippage for a $5,000 notional trade — I want to see depth within 1 and 5 cents of the touch and the 24h volume profile across Kalshi and Polymarket?

## When to prefer this

Use this endpoint when you need execution-quality liquidity analytics — depth, spread, and volume profile — for a specific prediction market. Prefer this over the per-venue implied odds endpoint when your primary concern is trading execution (slippage, fill quality) rather than probability comparison. This is the right choice when sizing a trade and needing to estimate market impact.

## Known failure modes

- Invalid or unknown market slug returns 404 not found
- notional_usd below 1 or above 100,000 returns 400 validation error
- Market exists but has no recent order book data returns empty per_venue array
- Payment of $0.03 USDC not included or insufficient returns 402 Payment Required
- Slug format violates pattern (not lowercase alphanumeric with hyphens) returns 400

## How this service works

Summarized depth, spread, and 24h volume profile for one market — Execution-quality summary per venue: depth within 1c/5c of the touch, spread in cents, and an hourly 24h volume profile. Pass notional_usd for a slippage estimate. Derived analytics only — raw order books are never mirrored.

## Output

Returns per-venue liquidity data including depth within 1 cent and 5 cents of the touch, spread in cents, and optional estimated slippage for each venue (Kalshi, Polymarket), plus total 24h USD volume and an array of hourly volume data points over the past 24 hours.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "slug"
     ],
     "properties": {
      "slug": {
       "type": "string",
       "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "notional_usd": {
       "type": "number",
       "maximum": 100000,
       "minimum": 1
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data",
      "meta"
     ],
     "properties": {
      "data": {
       "type": "object",
       "required": [
        "per_venue",
        "volume_24h_usd",
        "volume_profile_24h"
       ],
       "properties": {
        "per_venue": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "venue",
           "depth_within_1c_usd",
           "depth_within_5c_usd",
           "spread_c"
          ],
          "properties": {
           "venue": {
            "enum": [
             "kalshi",
             "polymarket"
            ],
            "type": "string"
           },
           "spread_c": {
            "type": "number"
           },
           "est_slippage_c": {
            "type": "number"
           },
           "depth_within_1c_usd": {
            "type": "number"
           },
           "depth_within_5c_usd": {
            "type": "number"
           }
          },
          "additionalProperties": false
         }
        },
        "volume_24h_usd": {
         "type": "number"
        },
        "volume_profile_24h": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "hour",
           "volume_usd"
          ],
          "properties": {
           "hour": {
            "type": "integer",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991
           },
           "volume_usd": {
   
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-factory-liquidity-summary-358c5ab3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-factory.com](https://www.zero.xyz/host/x402-factory.com/llms.txt)
