Support and feedback
How to report a problem with the API or its data, and what to include so it can be traced.
Report a problem
Use the contact page of this site. A report that includes the items below can usually be traced in one pass.
- The full request URL and the time of the call in UTC.
- The X-Request-Id response header, or request_id from the error body.
- What you expected and what you received. For a data question, the exchange, contract and the figure you compared against, with its capture time.
Before you report
- Check the status page for a current incident. Status →
- Check the data quality matrix for the exchange and data family involved. A STALE or UNAVAILABLE grade explains most missing values. Data quality →
- Check the reference page: unit, window and coverage differences explain most mismatches with other sources. Endpoint catalog →
- Reproduce the call in the Playground and copy the request ID from there. API Playground →
Data differences
CoinBoss numbers are computed from its own collection. They can legitimately differ from an exchange's website or another data site because of capture time, the set of exchanges and contract types included, single- versus double-sided open interest, units and window boundaries. Reports that state those five points get resolved fastest.
Request data or an endpoint
Missing an exchange, a field or an endpoint? Send the request through the contact page with the public exchange endpoint it could be collected from. Data that has no lawful public source stays marked UNAVAILABLE.
Frequently asked
- Is the API free?
- Yes. All data endpoints are public and free during the current period, limited to 1200 requests per minute.
- Do I need an API key?
- No. A key is optional and only changes how your requests are counted for rate limiting.
- Why is a value null?
- Because it is unknown: the exchange does not publish it, the record is stale, or it is not collected. The coverage block and the data quality page state the reason.
- Can I use the data commercially?
- See the terms of service of this site for the conditions of use.
- How do I know when something changes?
- The changelog lists every change. Changes within the current version are additive.