{"openapi":"3.1.0","info":{"title":"StickerCap partner API","version":"1.0.0","description":"Two read-only rails. `/set/{short_name}` resolves a Telegram sticker set to its permanent public record — use this to link out AT LAUNCH, because the short name is the only identifier that is already true before a token exists. `/authenticity/{chain}/{address}` answers whether the artwork behind a token is real, who drew it, and whether they endorsed it — that one needs a filed, linked token. No key is required during early access. One condition on the free tier: show 'powered by stickercap' wherever this data appears, linked to the `record_url` this API returns rather than to the homepage — a reader who lands on the exact record is already reading. Tell us when you ship and we will feature your tool in return."},"servers":[{"url":"https://www.stickercap.io"}],"paths":{"/api/v1/index/sticker20":{"get":{"summary":"STICKER20 — the docket's reference index","operationId":"getSticker20","parameters":[{"name":"series","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"false returns just the current level"},{"name":"X-API-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Optional during early access. Send it if you have one and your calls are attributed to you."}],"responses":{"200":{"description":"Cap-weighted, chain-linked daily, base 100. The methodology ships with the number: a partner rendering the level inherits the claim it makes.","content":{"application/json":{"example":{"index":"STICKER20","known":true,"value":159.16,"delta_24h_pct":-5.2,"regime":"risk-on","base":{"date":"2026-07-18","value":100.0},"as_of":"2026-08-23","constituents":20,"attribution":"STICKER20 by stickercap — https://www.stickercap.io","series":[{"date":"2026-07-18","value":100.0}]}}}}}}},"/api/v1/set/{short_name}":{"get":{"summary":"Resolve a sticker set to its record (the deep link)","operationId":"getSet","parameters":[{"name":"short_name","in":"path","required":true,"schema":{"type":"string"},"description":"The set's Telegram short name, as in t.me/addstickers/<short_name>. Case insensitive; a leading @ is tolerated.","example":"certifiedglowie"},{"name":"X-API-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Optional during early access. Send it if you have one and your calls are attributed to you."}],"responses":{"200":{"description":"Resolved, or an honest unknown. `known` false means no record is filed — absence is not an accusation, and filing is free.","content":{"application/json":{"examples":{"filed":{"value":{"query":{"short_name":"certifiedglowie"},"known":true,"record_url":"https://www.stickercap.io/set/certifiedglowie","title":"certified glowie","thumbnail_url":"https://www.stickercap.io/api/thumbs/certifiedglowie","telegram_url":"https://t.me/addstickers/certifiedglowie","created":"2026-08-18T01:04:00+00:00","is_official_telegram":false,"creator":{"telegram_id":6330629460,"handle":null,"handle_note":"resolved creator handles need a key — free, https://www.stickercap.io/api-docs","authorship_basis":"set_id >> 32 (Telegram protocol)"},"token":null}},"not filed yet":{"value":{"query":{"short_name":"nobody_filed_this"},"known":false,"record_url":null,"file_it_url":"https://t.me/stickercapbot","plain_english":"No record filed for this set yet. Paste it to the bot and the record exists immediately."}}}}}}}}},"/api/v1/authenticity/{chain}/{address}":{"get":{"summary":"Is the artwork behind this token real, and did its creator endorse it?","operationId":"getAuthenticity","parameters":[{"name":"chain","in":"path","required":true,"schema":{"type":"string"},"example":"ton"},{"name":"address","in":"path","required":true,"schema":{"type":"string"},"description":"Token address, case preserved.","example":"EQAmaMdwCmpZNJSRfvbNZDu1HkjFbw2VtvvI1FDKvLJMgyXE"},{"name":"X-API-Key","in":"header","required":false,"schema":{"type":"string"},"description":"Optional during early access. Send it if you have one and your calls are attributed to you."}],"responses":{"200":{"description":"A verdict. Provenance leads; supply integrity caps it. Cached 10 minutes. UNKNOWN_ASSET when nothing is filed.","content":{"application/json":{"example":{"verdict":{"grade":"B","score":62,"flags":["UNATTESTED_BY_CREATOR"],"headline":"Filed, unattested."},"asset_provenance":{"known":true,"short_name":"certifiedglowie","record_url":"https://www.stickercap.io/set/certifiedglowie"},"supply_integrity":{"grade":"C","capped_by":"MINTABLE"},"market_context":{"market_cap_usd":null}}}}}}}}}}