{"uid":"cap_6ow7J5MQTUwoIG9iOw2r_","slug":"api-seerium-xyz-ffc29f7d","name":"Polymarket Builder Detail Analytics","description":"Crypto and prediction market intelligence through x402.","url":"https://api.seerium.xyz/v1/prediction/builders/detail","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":["builder"],"properties":{"builder":{"type":"string","minLength":1,"description":"Required Polymarket builder or creator name. Use /v1/prediction/builders first to discover current builder names."},"timePeriod":{"enum":["DAY","WEEK","MONTH","ALL"],"type":"string","description":"Optional selected period for builder detail and series rows. Defaults to MONTH."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"builder":"Example Builder","updatedAt":"2026-03-25T11:59:30.000Z","seriesRows":[],"timePeriod":"MONTH","selectedPeriod":{"dt":"2026-03-25T00:00:00.000Z","rank":1,"volume":1250000,"builder":"Example Builder","verified":true,"activeUsers":420,"builderLogo":null,"volumeShare":0.2976,"volumePerActiveUser":2976.19},"periodBreakdown":[{"dt":"2026-03-25T00:00:00.000Z","rank":1,"period":"MONTH","volume":1250000,"verified":true,"activeUsers":420,"builderLogo":null,"volumeShare":0.2976,"volumePerActiveUser":2976.19}]},"meta":{"requestId":"req_example_123","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000,"generatedAt":"2026-03-25T12:00:00.000Z"},"product":{"id":"polymarket-builder-detail","name":"Polymarket Builder Detail API","path":"/v1/prediction/builders/detail","price":"$0.1000","method":"GET","accepts":[{"payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000","scheme":"exact","network":"eip155:8453"},{"payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000","scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"service":"seerium-x402-api"}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"builder":"Kalshi_Official","timePeriod":"WEEK"}}},"response":{"data":{"builder":"Kalshi_Official","updatedAt":"2026-06-10T04:33:46.407Z","seriesRows":[],"timePeriod":"WEEK","selectedPeriod":null,"periodBreakdown":[{"dt":null,"rank":null,"period":"DAY","volume":0,"verified":false,"activeUsers":0,"builderLogo":null,"volumeShare":0,"volumePerActiveUser":null},{"dt":null,"rank":null,"period":"WEEK","volume":0,"verified":false,"activeUsers":0,"builderLogo":null,"volumeShare":0,"volumePerActiveUser":null},{"dt":null,"rank":null,"period":"MONTH","volume":0,"verified":false,"activeUsers":0,"builderLogo":null,"volumeShare":0,"volumePerActiveUser":null},{"dt":null,"rank":null,"period":"ALL","volume":0,"verified":false,"activeUsers":0,"builderLogo":null,"volumeShare":0,"volumePerActiveUser":null}]},"meta":{"builder":"Kalshi_Official","requestId":"a186569f-f635-4a23-a1c0-546ed2b301b1","updatedAt":"2026-06-10T04:33:46.407Z","periodRows":0,"seriesRows":0,"timePeriod":"WEEK","freshnessMs":734,"generatedAt":"2026-06-10T04:33:47.141Z"},"product":{"id":"polymarket-builder-detail","name":"Polymarket Builder Detail API","path":"/v1/prediction/builders/detail","price":"$0.0010","method":"GET","accepts":[{"payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.0010","scheme":"exact","network":"eip155:8453"},{"payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.0010","scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"service":"seerium-x402-api"}},"exampleRequest":{"builder":"Kalshi_Official","timePeriod":"WEEK"},"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_X83oZiH5HuOVlifPU-G8U","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns detailed Polymarket builder/creator analytics including volume, active users, verification status, period breakdown, and time series rows for a single creator.","exampleAgentPrompt":"Pull the detailed Polymarket builder analytics for 'Kalshi_Official' over the last WEEK — I want to see their volume, active users, verification status, and the time series breakdown.","exampleUseCases":[{"title":"Evaluate prediction market creator credibility","prompt":"Can you get the full profile for 'PredictIt_Markets' and show me their verification status, total trading volume, and how many active users they've engaged over the last MONTH? I need to assess whether they're a legitimate builder."},{"title":"Track top builder performance trends weekly","prompt":"Pull the analytics for 'Metaculus_Official' over the last WEEK including their volume trends, active user counts, and time series data — I want to see if their market activity is growing or declining."},{"title":"Compare creator activity across different periods","prompt":"Give me the detailed breakdown for 'Gnosis_Safe' showing their volume, user engagement, and period-by-period performance across DAY, WEEK, and MONTH views so I can understand their seasonal patterns."}],"resultDescription":"A structured profile of a single Polymarket builder including total volume, active user counts, verification status, a breakdown of activity by the selected time period (DAY/WEEK/MONTH/ALL), and time series rows showing historical performance trends.","failureModes":["Builder name not found or misspelled — returns empty or error response","Invalid timePeriod enum value — returns validation error","Builder has no data for the selected period — returns empty series rows","API rate limiting or payment failure via x402 — returns 402 or 429 status"],"whenToPreferThis":"Use this endpoint when you need deep analytics on a specific individual Polymarket builder/creator rather than a broad market scan. It is best when you already know the creator's name and want volume, user engagement, verification status, and time series trends for that one creator specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:46:00.541Z","isFirstParty":false}