Developers / REST API reference

REST API reference

The explorer's own HTTP API. Lightweight JSON wrappers over JSON-RPC, plus computed views (balance formatting, validator metadata, QBFT consensus parameters). All endpoints are GET and return JSON.

GET/api/stats

Chain statistics, latest block number and average block time over the last 20 blocks.

Response shape

{
  "blockNumber": 106500,
  "avgBlockTime": "5.0"
}

Example

curl -s https://chain.kxco.ai/api/stats

GET/api/blocks

The 10 most recent blocks (headers only, no transaction details).

Response shape

[
  {
    "number":       106500,
    "hash":         "0x...",
    "parentHash":   "0x...",
    "timestamp":    1779260000,
    "gasUsed":      0,
    "gasLimit":     30000000,
    "txCount":      0,
    "transactions": [],
    "miner":        "0x...",
    "size":         842,
    "extraData":    "0x..."
  },
  ...
]

Example

curl -s https://chain.kxco.ai/api/blocks

GET/api/block/[id]

A single block by number or hash, with the full list of transaction hashes.

Path params

string

block number (decimal) or 32-byte block hash (0x-prefixed)

Response shape

{
  "number":       106500,
  "hash":         "0x...",
  "parentHash":   "0x...",
  "timestamp":    1779260000,
  "gasUsed":      0,
  "gasLimit":     30000000,
  "txCount":      0,
  "transactions": [],
  "miner":        "0x...",
  "size":         842,
  "extraData":    "0x..."
}

Example

curl -s https://chain.kxco.ai/api/block/106500
curl -s https://chain.kxco.ai/api/block/0xa55d5fd66e19dd3a146c9037e9f8fb563b760f4f2b57cc99c0ae8bc54e3d5759

GET/api/txns

The 10 most recent transactions across recent blocks. Results are cached for 20 seconds. Scans the last 200 blocks.

Response shape

[
  {
    "hash":        "0x...",
    "blockNumber": 106500,
    "timestamp":   1779260000
  },
  ...
]

Example

curl -s https://chain.kxco.ai/api/txns

GET/api/tx/[hash]

A single transaction with its receipt.

Path params

hash

DATA(32)

32-byte transaction hash

Response shape

{
  "hash":        "0x...",
  "blockNumber": 106500,
  "from":        "0x...",
  "to":          "0x...",
  "value":       "0x0",
  "gas":         21000,
  "gasPrice":    "0x0",
  "nonce":       0,
  "input":       "0x",
  "status":      "Success",
  "gasUsed":     21000
}

Example

curl -s https://chain.kxco.ai/api/tx/0xabc...

GET/api/address/[addr]

ARMR balance for an address, formatted to four decimal places.

Path params

addr

DATA(20)

20-byte account address

Response shape

{
  "address":     "0x...",
  "balance":     "1234.5678",
  "blockNumber": 106500
}

Example

curl -s https://chain.kxco.ai/api/address/0x2c7754df344baa04460cbf88bbade1b3a2b4dba4

GET/api/validators

Active QBFT validator set with metadata (name, PQC address, blocks proposed in recent window).

Response shape

{
  "validators": [
    {
      "address":        "0x2c7754df...",
      "name":           "node1",
      "pqcAddress":     "0x563e34dd...",
      "blocksProposed": 13,
      "isActive":       true
    },
    ...
  ],
  "totalValidators":    4,
  "faultTolerance":     1,
  "consensusThreshold": 3,
  "sampleBlocks":       50
}

Example

curl -s https://chain.kxco.ai/api/validators

GET/api/governance

Validator set plus QBFT consensus parameters.

Response shape

{
  "validators": [ ... ],
  "qbft": {
    "n":                     4,
    "f":                     1,
    "threshold":             3,
    "blockPeriodSeconds":    2,
    "requestTimeoutSeconds": 10
  }
}

Example

curl -s https://chain.kxco.ai/api/governance

Need something not listed here? The full JSON-RPC surface is exposed at /developers/rpc. This REST layer exists for convenience, anything it does can be done directly against the RPC endpoint.