Skip to Content
Supported ChainsOptimism
Supported ChainOptimism

Optimism API

Access Optimism via the Spectrum unified API. Optimism is an Ethereum L2 optimistic rollup with low fees, inheriting Ethereum’s security while offering significantly cheaper transactions.

Note: L2 gas on Optimism is significantly lower than Ethereum mainnet, making it an excellent choice for cost-sensitive applications.

Properties

PropertyValue
Slugoptimism
TypeEVM L2
Native TokenETH
Chain ID10

Available Methods

MethodDescription
getBlockHeightLatest Optimism block number
getBalanceETH 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
getChainHealthOptimism RPC health check

Quick Start

Get the latest Optimism 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": "optimism"
  },
  "id": 1
}

Get Balance

Retrieve the ETH balance for a wallet address on Optimism:

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": "optimism",
    "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('optimism');
console.log(block.height);
 
// Get ETH balance on Optimism
const balance = await spectrum.tokens.getBalance('optimism', '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045');
console.log(balance.balance);

DeFi

Optimism is supported by the following DeFi protocols on Spectrum:

  • Aave V3 — lending and borrowing markets
// Get Aave V3 lending yields on Optimism
const yields = await spectrum.yields.getLending({
  chain: 'optimism',
  protocol: 'aave-v3'
});
BNB ChainBase