Decryptr API
Read Decryptr's community data, news signals, market data and Hyperliquid-derived derivatives data from your software. Trending coins, posts and profiles, public trades and track records, news signals, candles, funding, liquidations, order flow and whale positioning over a plain REST API.
The Decryptr API gives your software read access to Decryptr's data. That is the community's own aggregates (what people log as trades, how those trades turn out, how traders lean, how Levels rounds resolve), public person-level data (profiles, posts, replies, communities, lists, and verified trading records from people who chose to share theirs), news signals and the economic calendar, market data (coins, prices, candles, funding, open interest, long and short ratios, liquidations and trending coins), and derivatives figures that Decryptr derives from Hyperliquid's public data.
It is a REST API that returns JSON, at https://data.decryptr.ai. Every path starts with /v1, and every request is a GET with an API key in a header.
What is in v1
| Data | Endpoint | From plan |
|---|---|---|
| API status (no key needed) | /v1/status | Any |
| Your plan, limits and units used | /v1/usage | Any |
| Trending coins on Decryptr | /v1/trending/coins | Developer |
| Trade outcomes per asset | /v1/calls/outcomes | Developer |
| Most-logged coins | /v1/calls/most-called | Starter |
| Trader sentiment for several assets, and per day for one | /v1/sentiment/callers, /v1/sentiment/{asset} | Developer |
| Crowd lean from trades and Levels | /v1/analytics/crowd/{asset} | Starter |
| Coin snapshot of Decryptr fields | /v1/coins/{asset} | Developer |
| Prop firm programme rules | /v1/prop/programs | Developer |
| Levels rounds and crowd split | /v1/levels/rounds, /v1/levels/rounds/{id} | Pro |
| Liquidation levels | /v1/liquidations/{asset} | Starter |
| Order flow delta | /v1/orderflow/delta | Starter |
| Order flow footprint | /v1/orderflow/footprint | Pro |
| Funding and open interest | /v1/derivatives/{asset}/funding | Starter |
| Whale positions and positioning | /v1/whales/positions, /v1/whales/positioning | Pro |
| Public trades | /v1/calls, /v1/calls/{id} | Pro |
| Trader track records | /v1/callers, /v1/callers/{handle} | Pro |
| Verified traders who share their record | /v1/traders, /v1/traders/batch, /v1/traders/{id} | Pro |
| Leaderboard of traders who share their record | /v1/leaderboard | Pro |
| News signals: headline, source, link, and Decryptr's summary, tags and sentiment | /v1/signals, /v1/signals/{id}, /v1/signals/{id}/impact, /v1/sentiment/{asset}/news | Starter |
| Live news signal stream | /v1/stream/signals | Pro |
| Economic calendar | /v1/calendar, /v1/events/{id}/calls | Starter |
| Market data: coins, tickers, candles, funding, open interest, long and short ratios, liquidation heatmap and totals, trending | /v1/market/* | Developer, with funding, open interest, long and short and liquidations from Starter |
| Profiles, posts, replies and search | /v1/profiles/{handle}, /v1/posts, /v1/posts/{id}, /v1/posts/{id}/replies, /v1/coins/{asset}/posts, /v1/trending/posts, /v1/search/people, /v1/search/posts | Pro |
| Live public post stream | /v1/stream/posts | Business |
| Communities, rooms and lists | /v1/communities, /v1/communities/{slug}, /v1/communities/{slug}/posts, /v1/communities/{slug}/activity, /v1/communities/{slug}/members/history, /v1/rooms, /v1/rooms/{id}/activity, /v1/lists/{id} | Starter and Pro |
| Trending topics and tags, tag volume | /v1/trending/topics, /v1/trending/tags, /v1/tags/{tag}/volume | Starter and Pro |
| Levels leaderboard and round distribution | /v1/leaderboards/levels, /v1/levels/rounds/{id}/distribution | Pro |
| Prop firm stats, trader prop records and wallets, whale leaderboard | /v1/prop/firms/{firm}/stats, /v1/traders/{id}/prop, /v1/traders/wallets, /v1/whales/leaderboard | Pro and Business |
| Deletions you must apply | /v1/tombstones | Starter |
Everything the API returns is information. Nothing in it is a recommendation to buy or sell, and there are no fields for entries, targets or stops. Returns and moves are percentages that Decryptr computes, never prices. See Data and licensing for where each figure comes from.
The Hyperliquid-derived endpoints, the market data endpoints and the calendar carry an attribution line in every response, and you must keep it with the data. See Data and licensing.
Market data is served during a testing phase and may be restricted before general availability. Person-level data, including profiles, posts, replies, search, communities and lists, covers public accounts that have not opted out of API visibility, and never private accounts. Verified trading records appear only for people who switched on Share my record through the API, which is off by default. If you store person-level data, read /v1/tombstones at least daily and delete what it lists within 24 hours. See Data and licensing.
How it is priced
You pay for units, and one unit is one item returned or asked for: a list that returns 37 items costs 37 units at 1 unit each, and a batch of 5 assets costs 5 units. Richer items cost more, so liquidation levels cost 3 units and footprint candles 2 each. Searches cost 5 units plus 1 per result, and streams cost 1 unit per event delivered. The free Developer plan includes 1,000 units a month. Plans and pricing has the full table, and Rate limits and quotas explains the counting.