Authentication and CORS

  • No API key or token is required.
  • The API is read-only and accepts no transaction submission.
  • CORS allows GET, POST, and OPTIONS from any origin.

Read capacity

Reads share a bounded capacity. When it is exhausted the service returns 429. Back off and retry with increasing delays; sustained retry storms extend the recovery time.

Data scope limits

  • Global block, Action, and address lists first take the newest 10,000 candidates, then apply filters. Older history is outside the browse window — use the stable cursor endpoints for deep pagination over non-empty blocks.
  • DEX pages are fixed at 20 items per page.
  • In-block Action lists are not capped by the 10,000 window.
  • The Action type catalog returns at most 1,000 rows.
  • Search suggestions return at most 10 per category; the search text is at most 256 bytes.
  • DEX date filters are UTC+8 calendar days in YYYY-MM-DD.