{"uid":"cap_S1hwITbua0Mt5Q0062bwr","slug":"x402-factory-prediction-market-liquidity-analytics-07abb1ff","name":"x402-factory Prediction Market Liquidity Analytics","description":"Paid data APIs for AI agents: prediction-market analytics, weather intelligence, weather×market edge signals, and SEC/gov data. Paid endpoints use the x402 protocol (HTTP 402 + USDC on Base): call without payment to receive requirements, retry with an X-PAYMENT header. Machine-readable catalog: /llms.txt. Per-endpoint docs: /docs/{id}.","url":"https://x402-factory.com/v1/liquidity/%7Bslug%7D?utm_source=zero.xyz","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":{"type":"json","example":{"data":{"per_venue":[{"venue":"kalshi","spread_c":1,"est_slippage_c":0.11,"depth_within_1c_usd":43511.16,"depth_within_5c_usd":220022.94},{"venue":"polymarket","spread_c":1,"est_slippage_c":0.14,"depth_within_1c_usd":52295.06,"depth_within_5c_usd":175633.51}],"volume_24h_usd":591880.68,"volume_profile_24h":[{"hour":13,"volume_usd":22654.53},{"hour":14,"volume_usd":28433.7},{"hour":15,"volume_usd":23554.93},{"hour":16,"volume_usd":24849.59},{"hour":17,"volume_usd":27004.33},{"hour":18,"volume_usd":24873.7},{"hour":19,"volume_usd":20998.15},{"hour":20,"volume_usd":22003.64},{"hour":21,"volume_usd":31425.32},{"hour":22,"volume_usd":24433.02},{"hour":23,"volume_usd":28671.91},{"hour":0,"volume_usd":21033.08},{"hour":1,"volume_usd":19440.17},{"hour":2,"volume_usd":27355.65},{"hour":3,"volume_usd":33541.3},{"hour":4,"volume_usd":19872.25},{"hour":5,"volume_usd":20189.92},{"hour":6,"volume_usd":28022.61},{"hour":7,"volume_usd":25217.71},{"hour":8,"volume_usd":20702.89},{"hour":9,"volume_usd":26834.01},{"hour":10,"volume_usd":22330.71},{"hour":11,"volume_usd":22008.88},{"hour":12,"volume_usd":19213.25}]},"meta":{"docs":"https://x402-factory.com/docs/probability.liquidity","sources":["kalshi","polymarket"],"version":"1.0.0","endpoint":"/v1/liquidity/{slug}","data_mode":"live","freshness":"realtime","request_id":"req_00000000","generated_at":"2026-08-21T03:58:58.104Z"}}},"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_n5G5X1Mo6TTiuwlQVeQ6Z","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 real-time liquidity analytics for a prediction market by slug, including bid-ask spreads, order book depth, slippage estimates, and 24-hour volume profiles across Kalshi and Polymarket.","exampleAgentPrompt":"What's the current liquidity situation for the 'us-presidential-election-2026' market — give me the spread, order book depth within 1 cent and 5 cents, and estimated slippage on both Kalshi and Polymarket, along with the 24-hour volume profile.","exampleUseCases":[{"title":"Pre-trade slippage check for large position","prompt":"Before I put $20,000 into the 'fed-rate-cut-september' market, can you check the order book depth and estimated slippage across Kalshi and Polymarket so I know what price impact to expect?"},{"title":"Best venue routing for prediction market trade","prompt":"I want to trade the 'us-inflation-above-3-percent' contract — can you pull the spreads and depth on both Kalshi and Polymarket so I can see which venue has better liquidity right now?"},{"title":"Hourly volume pattern analysis","prompt":"Show me the 24-hour volume profile for the 'next-world-series-winner' prediction market — I want to know which hours of the day see the most trading activity so I can time my entry."}],"resultDescription":"A JSON object with per-venue breakdown (Kalshi and Polymarket) of bid-ask spread in cents, estimated slippage in cents, and order book depth within 1¢ and 5¢ in USD; plus aggregate 24-hour volume in USD; and an hourly volume profile array (hour, volume_usd) covering the last 24 hours. Metadata includes data source, freshness, endpoint version, and a unique request ID.","failureModes":["Invalid or non-existent slug returns 404 or empty data object","Market not listed on either venue returns empty per_venue array","Slug format mismatch (not kebab-case) causes 400 validation error","Payment not provided returns HTTP 402 with X-PAYMENT requirements","Temporary venue API outage may reduce per_venue coverage to one source","notional_usd outside 1–100000 range causes schema validation rejection"],"whenToPreferThis":"Use this endpoint when you need real-time microstructure data (spread, depth, slippage, volume) for a specific prediction market contract across Kalshi and Polymarket. Prefer it over generic market price endpoints when the goal is execution quality assessment — understanding if and how cheaply a position can be entered or exited — rather than just fetching a probability or price. Best for trading bots, arbitrage detection, and liquidity-aware order routing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:40:21.871Z","isFirstParty":false,"canonicalSlug":"x402-factory-prediction-market-liquidity-analytics-07abb1ff"}