Public posts about a coin
Person-level data (on since 23 Oct 2026): only public accounts that have not opted out (API visibility), never private, banned or suspended accounts, and only content created on or after Decryptr's content date. Authors carry a pseudonymous id (trd_). When content is deleted, hidden or its author leaves, /v1/tombstones lists it: delete your copy within 24 hours. Public posts tagged with a coin, newest first: the coin's feed, including posts in its coin community.
Cost: 1 call per item returned, at least one item's worth. The request first reserves limit x 1 calls (and is refused with 429 if that many are not available), then pays only for what came back.
Needs scope social:read and the pro plan or above.
AuthorizationBearer <dcr_live_<8 hex>_<43 base64url> or dcr_test_...>Your API key as a Bearer token: Authorization: Bearer dcr_live_....
asset*stringAsset symbol, letters and digits, case-insensitive.
^[A-Za-z0-9]{1,15}$since?stringOnly items at or after this time (ISO 8601 with offset). Must be inside your plan's history (Developer 7 days, Starter 30, Pro 365, Business all). Defaults to the start of your history.
date-timeuntil?stringOnly items at or before this time (ISO 8601 with offset). Defaults to now; on Developer it is capped 60 minutes before now.
date-timecursor?stringnext_cursor from the previous page, passed back as it is. Opaque: do not build or change it.
length <= 300limit?integerItems to return, 1 to 100. Your plan allows max_page calls per request (Developer 10, Starter 25, Pro 50, Business 100), so at most max_page divided by this endpoint's calls per item. Default 20, or that maximum if lower. The request reserves limit x calls per item before it runs: ask only for what you need.
1 <= value <= 100OK.
application/json- response
data*array<>as_of*stringWhen the response was made.
date-timenext_cursor*|Pass as cursor for the next page. null when this is the last page.
disclaimer*stringPlain-language notice. Information only, not financial advice.
curl -X GET 'https://data.decryptr.ai/v1/coins/BTC/posts?since=2026-10-20T00%3A00%3A00Z&until=2026-10-23T12%3A00%3A00Z&cursor=eyJ0IjoiMjAyNi0xMC0yM1QxMDowMDowMC4wMDBaIn0&limit=10'{ "data": [ { "id": "00000000-0000-4000-8005-0000000000c8", "author": { "id": "trd_000000000000000000000001", "handle": "sample_user_1" }, "text": "Sample post 200 about $BTC.", "asset": "BTC", "community": "sample-community", "created_at": "2026-10-23T12:22:00.000Z", "edited_at": null, "counts": { "likes": 0, "replies": 0, "reposts": 0, "views": 100 }, "quote_of": null, "reply_to": null, "thread_root": null, "kind": "poll", "sensitive": false, "has_media": true }, { "id": "00000000-0000-4000-8005-0000000000c4", "author": { "id": "trd_000000000000000000000005", "handle": "sample_user_5" }, "text": "Sample post 196 about $BTC.", "asset": "BTC", "community": null, "created_at": "2026-10-23T11:54:00.000Z", "edited_at": null, "counts": { "likes": 28, "replies": 4, "reposts": 0, "views": 104 }, "quote_of": null, "reply_to": null, "thread_root": null, "kind": null, "sensitive": false, "has_media": false }, { "id": "00000000-0000-4000-8005-0000000000c0", "author": { "id": "trd_000000000000000000000009", "handle": "sample_user_9" }, "text": "Sample post 192 about $BTC.", "asset": "BTC", "community": null, "created_at": "2026-10-23T11:26:00.000Z", "edited_at": null, "counts": { "likes": 6, "replies": 2, "reposts": 0, "views": 108 }, "quote_of": null, "reply_to": null, "thread_root": null, "kind": null, "sensitive": false, "has_media": false } ], "next_cursor": "eyJ0IjoiMjAyNi0xMC0yM1QxMToyNjowMC4wMDBaIiwiaWQiOiIwMDAwMDAwMC0wMDAwLTQwMDAtODAwNS0wMDAwMDAwMDAwYzAifQ", "as_of": "2026-10-23T12:22:30.000Z", "disclaimer": "Public content of Decryptr users who have not opted out. Apply every /v1/tombstones entry within 24 hours. Do not resell it, republish it in bulk or use it to train AI models."}Replies to a public post GET
Person-level data (on since 23 Oct 2026): only public accounts that have not opted out (API visibility), never private, banned or suspended accounts, and only content created on or after Decryptr's content date. Authors carry a pseudonymous id (trd_). When content is deleted, hidden or its author leaves, /v1/tombstones lists it: delete your copy within 24 hours. Replies to a public post, oldest first. 404 when the post itself is not served. Cost: 1 call per item returned, at least one item's worth. The request first reserves limit x 1 calls (and is refused with 429 if that many are not available), then pays only for what came back. Needs scope `social:read` and the pro plan or above.
Trending public posts GET
Person-level data (on since 23 Oct 2026): only public accounts that have not opted out (API visibility), never private, banned or suspended accounts, and only content created on or after Decryptr's content date. Authors carry a pseudonymous id (trd_). When content is deleted, hidden or its author leaves, /v1/tombstones lists it: delete your copy within 24 hours. Public posts of the last 24 hours or 7 days ranked by engagement (likes, plus replies and reposts counted twice). Cost: 1 call per item returned, at least one item's worth. The request first reserves limit x 1 calls (and is refused with 429 if that many are not available), then pays only for what came back. Needs scope `social:read` and the pro plan or above.