Overview

The REST API is a thin, read-only reader over the raw and decoded PostgreSQL tables. Field names match the column names. There is no parallel “API shape.”

Base URL

https://api.blocktrellis.com

Chain prefix

Every data route is scoped by chain: /v1/{chain}/…. Only ethereum is live; requesting an unregistered chain returns 404 rather than an empty result.

Conventions

JSON only. List endpoints paginate with an opaque cursor, not offset. Timestamps are ISO-8601 UTC. Hashes and addresses are 0x-prefixed lowercase. Wei-scale amount fields are always strings. Null means unknown or not applicable, never a sentinel string.

Versioning

The current prefix is /v1. Additive fields may appear without a version bump. Removed or renamed fields require /v2.