Working with the chain · ≈ 11 min

Reading the chain

Two free, no-auth ways to ask the network what is true — and the small mistakes that make each one fail.

There are two ways to read Animica, and they suit different jobs.

JSON-RPC, for anything precise:

curl -s -X POST https://rpc.animica.org/rpc \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"chain.getHead","params":{}}'

A real response, 2026-08-20:

"height": 78783, "chainId": 1,
"hash": "0x00000000003f8ce7149b5963c5d7c3a233b2f2acc067ac93c3138ffe6c793a69",
"thetaMicro": 26679469

Explorer REST, for anything convenient — no JSON-RPC envelope, no POST:

curl -s https://explorer.animica.org/api/head
curl -s https://explorer.animica.org/api/address/anim1…
curl -s https://explorer.animica.org/api/mining/info

Three things that will waste your afternoon.

1. The /rpc path is required. https://rpc.animica.org without it returns a 301 redirect, and most HTTP clients silently turn a redirected POST into a GET — so your call arrives with no body and fails in a way that looks like a server problem rather than a URL problem.

2. There is no chain.getHeight. Call chain.getHead and read height from it. Guessing method names by analogy with other chains does not work here; enumerate what exists at https://explorer.animica.org/api/rpc/discover.

3. Explorer balances are hex strings. /api/address/… returns "confirmedBalance": "0x177f2fef2643a", not a decimal number. Parse it base 16 and then divide by 10^9 for ANM. Reading it as decimal gives you a number that is wrong but plausible-looking, which is the worst kind of wrong.

Namespaces: chain.*, state.*, tx.*, mempool.*, net.*, aicf.* for AI compute, and flat l2_* methods for the rollup — note l2_status, not l2.status. There is no ai.* namespace at all.

All of this is free and unauthenticated. You do not need an API key to read Animica, and any tutorial that hands you one is describing a different chain.

Stuck? Ask

Answered by Animica's own free inference network. It is donated GPU capacity, so give it 20-30 seconds.