{"openapi":"3.1.0","info":{"title":"Cohven public data","version":"1.0.0","summary":"Read-only JSON and CSV behind the public pages of cohven.com.","description":"Polymarket wallet analytics rebuilt from Polygon on-chain data: the public track record of cohort consensus positions and every event where at least three tracked wallets took the same side. No authentication. Attribution required, see the license.","contact":{"name":"Cohven","email":"help@cohven.com","url":"https://cohven.com/about"},"license":{"name":"RSL 1.0 terms","url":"https://cohven.com/license.xml"}},"externalDocs":{"description":"Overview for language models","url":"https://cohven.com/llms.txt"},"servers":[{"url":"https://cohven.com"}],"paths":{"/track-record.json":{"get":{"operationId":"getTrackRecord","summary":"Every resolved consensus position with summary and weekly totals","responses":{"200":{"description":"Track record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackRecord"}}}}}}},"/track-record.csv":{"get":{"operationId":"getTrackRecordCsv","summary":"The same track record as CSV","responses":{"200":{"description":"CSV","content":{"text/csv":{"schema":{"type":"string"}}}}}}},"/polymarket/index.json":{"get":{"operationId":"listEvents","summary":"Polymarket events where the cohort reached consensus, paginated, with a next link","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":0}},{"name":"bucket","in":"query","schema":{"type":"string","enum":["politics","world","economy","crypto","culture","other"]}},{"name":"sort","in":"query","schema":{"type":"string","enum":["WALLETS","COMMITTED","REALISED","RECENT"]}}],"responses":{"200":{"description":"Event index page","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventIndex"}}}}}}},"/polymarket/{slug}/{marketSlug}/data.json":{"get":{"operationId":"getMarket","summary":"One market inside an event: sides, holders per side, entry, notional, realised P&L and recent book prices","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"marketSlug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Market","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No page for this market"}}}},"/wallets/index.json":{"get":{"operationId":"listWallets","summary":"Every wallet of the public cohort with equity, all-time P&L and consensus record","responses":{"200":{"description":"Wallet index","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/wallets/{address}/data.json":{"get":{"operationId":"getWallet","summary":"One tracked wallet: equity, P&L curve, consensus record, largest and recently resolved events","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}],"responses":{"200":{"description":"Wallet","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not a tracked wallet"}}}},"/wallets/{address}/{slug}/data.json":{"get":{"operationId":"getWalletEvent","summary":"One wallet inside one event: sides held, entry against the cohort entry, daily fills, result","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Wallet in event","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No page for this pair"}}}},"/polymarket/{slug}/data.json":{"get":{"operationId":"getEvent","summary":"One event: outcomes held, holders, entry prices, notional, realised P&L and daily fills","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Polymarket event slug from the index"}],"responses":{"200":{"description":"Event","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Event"}}}},"404":{"description":"Unknown slug"}}}}},"components":{"schemas":{"Attributed":{"type":"object","properties":{"source":{"type":"string","const":"Cohven"},"attribution":{"type":"string"},"page":{"type":"string","format":"uri"},"license":{"type":"string","format":"uri"}}},"TrackRecord":{"allOf":[{"$ref":"#/components/schemas/Attributed"},{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"summary":{"type":"object","properties":{"quorum":{"type":"integer"},"walletsTotal":{"type":"integer"},"positions":{"type":"integer"},"won":{"type":"integer"},"lost":{"type":"integer"},"hitRate":{"type":"number","description":"Share of positions resolved on the cohort side, 0 to 1"},"cost":{"type":"number","description":"USD"},"pnl":{"type":"number","description":"Realized P&L summed across holding wallets, USD"},"firstWeek":{"type":"string","format":"date"},"lastWeek":{"type":"string","format":"date"}}},"weeks":{"type":"array","items":{"$ref":"#/components/schemas/Week"}},"positions":{"type":"array","items":{"$ref":"#/components/schemas/Position"}}}}]},"Week":{"type":"object","properties":{"week":{"type":"string","format":"date"},"positions":{"type":"integer"},"won":{"type":"integer"},"lost":{"type":"integer"},"cost":{"type":"number"},"pnl":{"type":"number"},"cumulative":{"type":"number"}}},"Position":{"type":"object","properties":{"week":{"type":"string","format":"date"},"closedAt":{"type":"string"},"title":{"type":"string"},"outcome":{"type":"string"},"eventSlug":{"type":"string"},"holders":{"type":"integer"},"won":{"type":"boolean"},"cost":{"type":"number"},"pnl":{"type":"number"},"entry":{"type":["number","null"],"description":"Cost-weighted cohort entry price, 0 to 1"}}},"EventIndex":{"allOf":[{"$ref":"#/components/schemas/Attributed"},{"type":"object","properties":{"updatedAt":{"type":"string","format":"date"},"walletsTotal":{"type":"integer"},"events":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"bucket":{"type":"string"},"wallets":{"type":"integer"},"committed":{"type":"number"},"realised":{"type":["number","null"]},"trades":{"type":"integer"},"data":{"type":"string","format":"uri"}}}}}}]},"Event":{"allOf":[{"$ref":"#/components/schemas/Attributed"},{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"polymarket":{"type":"string","format":"uri"},"walletsTotal":{"type":"integer"},"walletsInEvent":{"type":"integer"},"committed":{"type":"number"},"realised":{"type":["number","null"]},"trades":{"type":"integer"},"firstFill":{"type":["string","null"],"format":"date"},"lastFill":{"type":["string","null"],"format":"date"},"resolvedAt":{"type":["string","null"],"format":"date"},"rows":{"type":"array","items":{"type":"object","properties":{"candidate":{"type":"string"},"outcome":{"type":["string","null"]},"holders":{"type":"integer"},"avg":{"type":["number","null"],"description":"Average entry price, 0 to 1"},"cost":{"type":"number"},"won":{"type":["boolean","null"]},"pnl":{"type":["number","null"]},"points":{"type":"array","description":"Daily fills: d date, p volume-weighted price, size shares, n fills, w wallets","items":{"type":"object"}}}}}}}]}}}}