Skip to Content
Supported ChainGnosis

Gnosis API

Access Gnosis Chain via the Spectrum unified API. Gnosis Chain is a community-owned EVM chain with xDAI as its native token, providing stable and predictable transaction costs.

Properties

PropertyValue
Sluggnosis
TypeEVM
Native TokenxDAI
Chain ID100

Available Methods

MethodDescription
getBlockHeightLatest Gnosis block number
getBalancexDAI balance for a wallet
getTokenBalanceERC-20 token balance
getTokenMetadataERC-20 token info
getTokenAllowanceToken spending allowance
getPortfolioFull portfolio with USD values
getNftCollectionNFT holdings for a wallet
getBlockTransactionsTransactions in a block
estimateGasGas estimation for a transaction
traceTransactionInternal call trace
getHistoricalBalanceBalance at a historical block
getCodeContract bytecode check
simulateCallSimulate a contract call
rpcProxyRaw JSON-RPC passthrough
getChainHealthGnosis RPC health check

Quick Start

Get the latest Gnosis block height:

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
{
  "jsonrpc": "2.0",
  "method": "getBlockHeight",
  "params": {
    "chain": "gnosis"
  },
  "id": 1
}

Get Balance

Retrieve the xDAI balance for a wallet address:

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
{
  "jsonrpc": "2.0",
  "method": "getBalance",
  "params": {
    "chain": "gnosis",
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
  },
  "id": 1
}

Get Gas

Compare current gas prices across chains:

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
{
  "jsonrpc": "2.0",
  "method": "compareGas",
  "params": {},
  "id": 1
}

SDK

import { Spectrum } from '@spectrum-nodes/sdk'; const spectrum = new Spectrum({ api: 'https://your-endpoint.simplystaking.xyz/YOUR_API_KEY/' }); // Get latest block height const block = await spectrum.core.getBlockHeight('gnosis'); console.log(block.height); // Get xDAI balance const balance = await spectrum.tokens.getBalance('gnosis', '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'); console.log(balance.balance);