Skip to Content
API ReferenceOverview

API Reference

The Spectrum API is exposed through a single JSON-RPC 2.0 endpoint.

Resources: OpenAPI JSON | Pagination Guide

Send all Spectrum requests to:

POST https://your-endpoint.simplystaking.xyz/v1

Include your Spectrum method name in method and pass parameters as an object in params:

{
  "jsonrpc": "2.0",
  "method": "getBalance",
  "params": {
    "chain": "ethereum",
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
  },
  "id": 1
}

cURL Example

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

Response:

{
  "jsonrpc": "2.0",
  "result": {
    "data": {
      "chain": "0x1",
      "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "token": "ETH",
      "balance": "32.126799033316011"
    }
  },
  "id": 1
}

Batch Requests

Send up to 50 calls in one HTTP request by posting an array to POST /v1.

For full request and response examples, see JSON-RPC Batch.

Endpoint Categories

CategoryDescriptionPage
BlocksBlock heights, block data, transactions in a blockBlocks
AccountsNative and token balances, historical balancesAccounts
TokensToken metadata, allowancesTokens
PortfolioFull wallet portfolio with USD valuesPortfolio
GasCross-chain gas comparisonGas
ReceiptsTransaction receipts, tracesReceipts
LogsEvent logs, ERC-20 transfersLogs
PricesToken prices, history, batch, top tokens, searchPrices
Token DiscoverySearch tokens, get addresses across chainsToken Discovery
ENSForward and reverse ENS resolutionENS
DeFi YieldsLending, vault, and staking APY/TVLYields
DeFi PositionsAave, Compound, Morpho, Lido, Curve positionsDeFi Positions
Swap QuotesUniswap V2/V3/V4, Jupiter quotesSwaps
PerpsFunding rates from Hyperliquid, dYdXPerps
ApprovalsToken approvals and revoke transactionsApprovals
NFTsCollections, balances, metadata, ownershipNFTs
RegistryProtocol contracts, ABIs, chain metadataRegistry
ContractsGas estimation, call simulation, contract codeContracts
JSON-RPC BatchMulti-method batch requests via POST /v1JSON-RPC Batch
RPC ProxyRaw JSON-RPC passthrough to chain nodesRPC Proxy
HealthAPI and chain health checksHealth

Address Formats

  • EVM: 0x-prefixed, 42 characters (e.g. 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045)
  • Solana: Base58-encoded (e.g. vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg)
  • Bitcoin: Bech32, P2PKH, or P2SH formats

Supported Chains

ChainSlugType
EthereumethereumEVM
PolygonpolygonEVM
BNB ChainbscEVM
OptimismoptimismEVM
BasebaseEVM
AvalancheavalancheEVM
ArbitrumarbitrumEVM
GnosisgnosisEVM
MoonbeammoonbeamEVM
LinealineaEVM
HyperliquidhyperliquidEVM
SolanasolanaSVM
BitcoinbitcoinUTXO

Error Responses

StatusMeaning
400Bad request: missing or invalid parameters
401Unauthorized: missing or invalid API key
404Not found: invalid chain slug or resource
429Rate limited: too many requests
500Internal server error
503Service unavailable: chain RPC is down
Credit UsageHealth