Osmosis API

Access Osmosis blockchain data through the Spectrum API. Osmosis is a Cosmos SDK appchain and the largest decentralized exchange in the Cosmos ecosystem.

Available methods

Osmosis supports the same Cosmos SDK method set as Cosmos Hub. See the Cosmos Hub page for full descriptions.

Blocks · Block transactions · Transactions · Receipts · Native balance (OSMO) · Denom balances (including IBC and gamm LP shares) · Denom supply · Token metadata · Cosmos staking suite · RPC proxy · Health.

EVM-only endpoints (logs, transfers, contract reads, ENS, NFTs, gas, simulateCall) are not supported.

Quick start

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \

{
  "jsonrpc": "2.0",
  "method": "getBlockHeight",
  "params": {
    "chain": "osmosis"
  },
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "chain": "osmosis",
    "height": 21345678
  },
  "id": 1
}

Get an OSMO balance

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \

{
  "jsonrpc": "2.0",
  "method": "getBalance",
  "params": {
    "chain": "osmosis",
    "address": "osmo1xyzabc..."
  },
  "id": 1
}

Get a denom balance (e.g., axlUSDC over IBC)

getTokenBalance accepts either a base denom (uosmo) or an IBC hash (ibc/...).

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \

{
  "jsonrpc": "2.0",
  "method": "getTokenBalance",
  "params": {
    "chain": "osmosis",
    "address": "osmo1xyzabc...",
    "token": "ibc/D189335C6E4A68B513C10AB227BF1C1D38C746766278BA3EEB4FB14124F1D858"
  },
  "id": 1
}

SDK

import { Spectrum } from '@spectrumnodes/sdk';
const spectrum = new Spectrum({ api: 'https://your-endpoint.simplystaking.xyz/YOUR_API_KEY/' });
 
const block = await spectrum.core.getBlockHeight('osmosis');
const balance = await spectrum.tokens.getBalance('osmosis', 'osmo1xyzabc...');
const delegations = await spectrum.cosmos.getDelegations('osmosis', 'osmo1xyzabc...');

Endpoint differences from EVM chains

See Endpoint differences. All Cosmos SDK chain pages share the same behaviour.

Related pages

• Cosmos Hub: Reference Cosmos SDK chain page
• Cosmos endpoints: Delegation, reward, and validator methods
• Supported Chains: All networks