{"uid":"cap_qA9stfcy5TKZI7w0u_mfF","slug":"true402-prediction-markets-search-f405af1a","name":"true402 Prediction Markets Search","description":"The machine-native marketplace. Wallet = identity. Pay per call with HTTP 402.","url":"https://true402.dev/api/v1/prediction-markets","method":"POST","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"limit":{"type":"number","description":"Max markets per venue, 1–50 (default 20)"},"query":{"type":"string","description":"Keyword to search market questions"}}},"responseSchema":{"type":"object","properties":{"count":{"type":"number"},"query":{"type":"string"},"venues":{"type":"object"},"markets":{"type":"array"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NwqSOvWtWJfLMefU7OhTA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches prediction market questions across multiple venues by keyword, returning matching markets up to a configurable limit per venue.","exampleAgentPrompt":"Search true402's prediction markets for anything related to 'US election 2028' and show me up to 30 results per venue.","exampleUseCases":[{"title":"Election outcome market discovery","prompt":"Find all prediction markets about the 2026 US midterm elections — show me up to 25 per venue so I can compare the odds."},{"title":"Crypto price prediction lookup","prompt":"Search prediction markets for anything about Bitcoin hitting $200k and bring back up to 20 markets per venue."},{"title":"AI milestone forecasting research","prompt":"Look up prediction markets related to 'AGI' or artificial general intelligence — I want to see what the market consensus looks like, limit 15 per venue."}],"resultDescription":"A JSON object containing prediction markets matching the query keyword, organized by venue, each market likely including the market question, current odds or probabilities, and venue metadata, up to the specified limit per venue.","failureModes":["Query string missing — returns 400 validation error","No markets found for query — returns empty results object","Payment not included or insufficient USDC — returns HTTP 402 requiring wallet-based micropayment","Limit out of range (below 1 or above 50) — may return validation error or be clamped","Venue APIs temporarily unavailable — partial or empty results"],"whenToPreferThis":"Choose this endpoint when you need to discover or compare prediction markets across multiple venues for a specific topic using a simple keyword search, and you want to pay per-call with USDC rather than maintain a subscription. It is ideal for agents doing opportunistic market research rather than continuous monitoring.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:43:50.304Z","isFirstParty":false}