Blog
Engineering and product notes on how Onekey behaves, written from the real API, with snippets that were run. Subscribe with the Atom feed.
Credits, refunds and what a failed call costs
A balance walk through real calls on 2026-09-30, showing which ones charge, which are free, and how to check your balance around a call without spending anything.
Honest nulls: what we return when a platform has no value
A missing follower count is not zero, and an empty bio is not an empty string. How Onekey tells you a value is unknown, and how to read it without re-inventing the lie.
How idempotent retries work, and why a replay costs 0 credits
A timeout does not tell you whether you were billed. The Idempotency-Key header does. What the server stores, every outcome, and a retry loop you can run.
One canonical schema across 266 platforms, and what we leave in ext
What Onekey normalises (names, types, dates, URLs, text), what it deliberately does not, and how to check the numbers yourself with one free call.
Signed webhooks: verifying Onekey monitor events
How a monitor delivery is signed, how to verify it in Python, Node or the shell without getting bitten by JSON re-serialising, and what happens when your endpoint fails.
Why every list uses one cursor shape
Sources page in three different ways. Onekey hides that behind a single pagination block and a signed cursor. Here is what is in it, what it refuses, and what a page costs.