KarmaScan Data API
The numbers behind KarmaScan as an API: Reddit crypto sentiment since 2013 for the market, 128 projects and the accounts driving the conversation. Every post and comment is scored for market outlook by an LLM under a published rubric.
Free
$0
- ✓100 calls a month
- ✓Whole-market monthly bullish share, volume and active accounts
- ✓Monthly mentions and bullish share for all 128 projects
- ✓Last 3 months
Member
$25 / month
or $250 a year
- ✓10,000 calls a month
- ✓Everything in Free, plus KOL leaderboards for every category
- ✓Per-account monthly stance and the projects each account talks about
- ✓Most bullish and most bearish accounts per project
- ✓Last 12 months
Pro
$299 / month
- ✓50,000 calls a month
- ✓Everything in Member, with full history back to 2013
Premium
$999 / month
- ✓Everything in Pro
- ✓1,000,000 exact posts and comments a month, more at $1 per 1,000
- ✓Text, author, date and permalink on every one
- ✓A sentiment score, stance, quality and tags on every row
- ✓Monthly, weekly and daily theme write-ups with their bullish shares
Keys are issued on request for now. Tell us your use case and the tier you need. Plans are for your own use; resale and bulk licences go through sales.
Request an API keyAuthentication
Send your key in the X-API-Key header. Each response reports your monthly quota in X-Quota-Limit and X-Quota-Remaining.
curl -H "X-API-Key: ks_live_..." \ "https://karmascan-api.vercel.app/api/data/v1/market/monthly?start=2025-10&end=2026-09"
Endpoints
Base URL https://karmascan-api.vercel.app/api/data/v1. Months are UTC calendar months; the current month is partial. Free reads the last 3 full months plus the current one, Member the last 12, Pro and Premium back to March 2013.
| Tier | GET | Returns |
|---|---|---|
| Free | /meta | Your tier, quota and the methodology |
| Free | /market/monthly?start=YYYY-MM&end=YYYY-MM | Market bullish share, volume, active accounts |
| Free | /projects | Tracked projects with category and launch month |
| Free | /projects/{slug}/monthly | A project’s mentions and bullish share by month |
| Member | /kols?category=Overall&start=&end=&limit=&offset= | KOL board for a category and month range |
| Member | /kols/{username}/monthly | An account’s karma, activity and stance by month |
| Member | /kols/{username}/projects | An account’s mentions and average score per project |
| Member | /projects/{slug}/voices?start=&end= | Most bullish and bearish accounts on a project |
| Premium | /messages?project=&author=&subreddit=&start=&end=&limit=&cursor= | Exact posts and comments, newest first, paged |
| Premium | /themes?period=month&start=YYYY-MM-DD&end=YYYY-MM-DD | Written theme summaries with bullish shares |
Message fields (Premium)
Filter by project or author; a date-only query spans at most 7 days. Up to 500 rows per page; pass next_cursor back as cursor for the next page.
| id, type, subreddit | Reddit id, post or comment, community |
| author, date, permalink | Who wrote it, UTC date, link to the original |
| title, text | Post title; post body or comment text, exactly as captured |
| parent_post_id, parent_comment_id | Thread position |
| score | Reddit score when captured |
| sentiment, stance | Market-outlook score 0 to 100 and its label |
| quality, tags | Substantive / low effort / spam, and topic tags |
| scorer, rubric | Which scoring pass produced the row, and the rubric version |
How the numbers are made
Bullish share counts only the posts and comments that took a side. History is being re-scored under the current rubric; until that finishes, different eras come from different scoring passes, and every row-level record says which. See the methodology.