{"uid":"cap_WIHwBxWSplGoEA8H6fYY8","slug":"prediction-market-similarity-search-81998cc2","name":"Prediction Market Similarity Search","description":"Find semantically similar prediction markets given an event_ticker.","url":"https://api.predictionmarketdata.io/prediction-markets/similar","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"},"queryParams":{"type":"object","required":["event_ticker","limit","offset"],"properties":{"limit":{"type":"string","description":"Maximum number of similar events to return."},"offset":{"type":"string","description":"Zero-based result offset."},"event_ticker":{"type":"string","description":"Source market identifier from /prediction-markets."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"similar":[{"score":0.91,"event_ticker":"spurs-vs-knicks-game-3.POLYMARK"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_4a1F438lUFO6cpaZSqy8J","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":"Returns semantically similar prediction markets given a source event ticker identifier.","exampleAgentPrompt":"Show me up to 10 prediction markets that are semantically similar to the event ticker INXU-2024-Q3 on predictionmarketdata.io, starting from the first result.","exampleUseCases":null,"resultDescription":"A paginated list of semantically similar prediction markets for the given source event ticker, likely including market identifiers, names, exchange info, and similarity signals.","failureModes":["Invalid or unknown event_ticker returns empty results or 404","Missing required event_ticker parameter returns 400 bad request","limit or offset out of range may return validation error","Payment failure (x402) if USDC balance is insufficient","Rate limiting if too many requests in a short period"],"whenToPreferThis":"Use this endpoint when you need to discover related or comparable prediction markets based on a known event ticker — ideal for building recommendation feeds, exploring correlated events, or diversifying a prediction market portfolio. Prefer over full-text search when semantic similarity is more important than keyword matching.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:45:05.006Z","isFirstParty":false}