API reference · Chain & reference
Elysium RPC
Free public Elysium mainnet RPC by Femtos (chain 99901), no key, read only (no transaction sending), for wallets and dapps, not for indexing (use the Femtos API for history): per IP 5 requests a second and 60 a minute, batches of 5, eth_getLogs over 1,000 blocks at most, state of the last 128 blocks only.
- Elysium
- HyperCore: not served
- HyperEVM: not served
- Not on HyperCore: HyperCore is no EVM chain: its own API is the Hyperliquid-compatible POST /info
- Not on HyperEVM: serves our own Elysium node; HyperEVM has public RPCs (Hyperliquid: rpc.hyperliquid.xyz/evm)
POST https://api.femtos.xyz/v1/elysium/rpc
Parameters
| Param | In | Example or values | Meaning |
|---|---|---|---|
jsonrpc | body | 2.0 | "2.0" |
id | body | 1 | Echoed in its answer; required (a notification, without one, is refused) |
method | body | eth_blockNumber | A method served: eth_chainId, eth_blockNumber, net_version, net_listening, web3_clientVersion, eth_syncing, eth_getBlockByNumber, eth_getBlockByHash, eth_getBlockTransactionCountByNumber, eth_getBlockTransactionCountByHash, eth_getTransactionByHash, eth_getTransactionByBlockNumberAndIndex, eth_getTransactionByBlockHashAndIndex, eth_getTransactionReceipt, eth_getBlockReceipts, eth_getBalance, eth_getCode, eth_getStorageAt, eth_getTransactionCount, eth_call, eth_estimateGas, eth_gasPrice, eth_maxPriorityFeePerGas, eth_feeHistory, eth_getLogs, eth_getProof (not available: eth_sendRawTransaction / eth_sendTransaction, eth_subscribe, filters, debug_*, trace_*) |
params | body | (optional) | Its parameters, as the method takes them (absent: none) |
Example
curl -X POST -H "Authorization: Bearer $FEMTOS_KEY" -H "Content-Type: application/json" "https://api.femtos.xyz/v1/elysium/rpc" \
-d '{"jsonrpc":"2.0","id":"1","method":"eth_blockNumber"}'Key: Authorization: Bearer $FEMTOS_KEY. Get a free key, or with no browser through agent onboarding.
Response fields
| Field | Type | Meaning |
|---|---|---|
jsonrpc | 2.0 | "2.0" |
id | number | string | null | The id of its request (null: a body or request that could not be read) |
result | unknown | The node's result, as it wrote it |
error | object | The node's error as it wrote it, or ours: -32600 invalid request or batch, -32601 method not available, -32602 invalid params, -32002 state older than the head's last 128 blocks, -32005 a limit (eth_getLogs range, answer size), -32603 node timeout, -32029 rate limit (HTTP 429): {code, message, data} |
Related: Chain & reference
- Freshness GET /v1/status Elysium, HyperCore, HyperEVM
Head and lag of each layer, measured now. - Blocks stream WS elysium.blocks · hyperevm.blocks Elysium, HyperEVM
Each new HyperEVM block header, small and big blocks, from our node. - Transaction GET /v1/tx/{hash} Elysium, HyperEVM
One transaction: status, gas, decoded transfers, swaps and liquidity, bridge legs and journey. - Stream stats WS stats HyperCore
Our HyperCore stream health, once a second. - Check your key GET /v1/whoami Elysium, HyperCore, HyperEVM
Answers the name your key is registered under, its tier, billing state and the limits in force. - OpenAPI document GET /v1/openapi.json Elysium, HyperCore, HyperEVM
The OpenAPI 3.1 contract of every REST call, public.
More
- This page as Markdown
- The whole API reference
- What Elysium serves
- The whole API in one Markdown file
- OpenAPI 3.1 document
Agent guide (agents.md)llms.txtOpenAPIMCP serverGet an API keyChangelog