{"uid":"cap_0fV_LKJDdCkCe7fYikblS","slug":"x402-factory-liquidity-summary-358c5ab3","name":"x402-factory Liquidity Summary","description":"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.","url":"https://x402-factory.com/v1/liquidity/:slug","method":"GET","headers":{},"bodySchema":{"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":{"type":"number"}},"additionalProperties":false}}},"additionalProperties":false},"meta":{"type":"object"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TxQuygBGRQQyeZrvhFsS6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:03:41.498Z","isFirstParty":false}