EOS - REST API

REST API endpoints supported on EOS Mainnet and EOS Jungle through Tatum RPC Gateway, with base URLs and an example request.

Call EOS REST endpoints through Tatum RPC Gateway. Append the endpoint path to the network's base URL and send your API key in the x-api-key header. See Authentication.

Base URLs

NetworkBase URL
EOS Mainnethttps://eos-mainnet.gateway.tatum.io
EOS Junglehttps://eos-jungle.gateway.tatum.io

Example request

curl 'https://eos-mainnet.gateway.tatum.io/v1/chain/get_info' \
  --header 'x-api-key: {YOUR_API_KEY}'

Endpoints

32 endpoints. Parameters and responses are described in the Spring Chain API reference; each method name links to its page there.

EndpointDescription
GET /v1/chain/get_infoReturns the chain state, including the head block, last irreversible block and chain ID.
POST /v1/chain/compute_transactionExecutes a transaction and returns its trace, then reverts all state changes.
POST /v1/chain/get_abiReturns the ABI of a contract account.
POST /v1/chain/get_accountReturns the details of an account.
POST /v1/chain/get_accounts_by_authorizersFinds the account permissions that the given accounts or public keys can satisfy.
POST /v1/chain/get_activated_protocol_featuresLists the activated protocol features.
POST /v1/chain/get_blockReturns a block by number or ID.
POST /v1/chain/get_block_header_stateReturns the header state of a block.
POST /v1/chain/get_block_infoReturns a fixed-size subset of the data of a block.
POST /v1/chain/get_codeReturns the WASM code of a contract account.
POST /v1/chain/get_code_hashReturns the code hash of a contract account.
POST /v1/chain/get_currency_balanceReturns the token balances of an account.
POST /v1/chain/get_currency_statsReturns the supply, maximum supply and issuer of a token.
POST /v1/chain/get_finalizer_infoReturns information about finalizers.
POST /v1/chain/get_infoReturns the chain state, including the head block, last irreversible block and chain ID.
POST /v1/chain/get_producer_scheduleReturns the current block producer schedule.
POST /v1/chain/get_producersLists block producers.
POST /v1/chain/get_raw_abiReturns the serialized ABI of a contract account.
POST /v1/chain/get_raw_code_and_abiReturns the raw code and ABI of a contract account.
POST /v1/chain/get_required_keysReturns which of the available public keys are required to sign a transaction.
POST /v1/chain/get_scheduled_transactionsLists scheduled (deferred) transactions.
POST /v1/chain/get_table_by_scopeLists the scopes of the tables of a contract.
POST /v1/chain/get_table_rowsReturns rows from a contract table.
POST /v1/chain/get_transaction_idReturns the ID of a transaction.
POST /v1/chain/get_transaction_statusReturns the status of a recent transaction by ID.
POST /v1/chain/push_blockPushes a block to the node.
POST /v1/chain/push_transactionPushes a signed transaction to the blockchain.
POST /v1/chain/push_transactionsPushes multiple signed transactions to the blockchain.
POST /v1/chain/send_read_only_transactionExecutes a read-only transaction without including it in the blockchain.
POST /v1/chain/send_transactionSends a signed transaction to the blockchain.
POST /v1/chain/send_transaction2Sends a signed transaction, with optional retries and the full trace of a failure.
POST /v1/trace_api/get_blockReturns the trace of a block, with its transactions and actions.

The gateway lists its supported endpoints at runtime:

Endpoint unavailable?

If you need an endpoint we don't support yet, contact support.