Odin Protocol Validator Tools & Infrastructure Documentation

This guide explains how to query network metrics from the Lavender.Five API endpoints.

#Network Information

Get current network statistics and information for a specific network:

GET api.lavenderfive.com/networks/__networkname__
Copy

Example response for secretnetworkCopy:

{
  "name": "secretnetwork",
  "pretty_name": "Secret Network",
  "image_url": "https://raw.githubusercontent.com/cosmos/chain-registry/master/secretnetwork/images/scrt.svg",
  "staking_url": "https://restake.app/secretnetwork/secretvaloper1t5wtcuwjkdct9qkw2h6m48zu2hectpd6ulmekk",
  "staking_denom": "uscrt",
  "denom_decimals": 6,
  "token_symbol": "SCRT",
  "network_website": "https://scrt.network/",
  "mainnet": true,
  "tendermint": true,
  "rest_endpoint": "https://rest.lavenderfive.com:443/secretnetwork",
  "rpc_endpoint": "https://rpc.lavenderfive.com:443/secretnetwork",
  "grpc_endpoint": "secretnetwork.lavenderfive.com:443",
  "ws_endpoint": "wss://rpc.lavenderfive.com:443/secretnetwork/ws",
  "jsonrpc_endpoint": "",
  "snapshots": "https://snapshots.lavenderfive.com/snapshots/secretnetwork/latest.tar.lz4",
  "genesis": true,
  "community_tax": 0,
  "unbonding_time": 21,
  "max_validators": 80,
  "block_speed": 5.8019319999218,
  "staking_apr": "20.38",
  "staking_apy": "22.6",
  "real_apr": "11.35",
  "real_apy": "12.02",
  "inflation": 9.03005360101581,
  "total_supply": 313018191.535164,
  "max_supply": null,
  "bonded_supply": 135879485.654572,
  "bonded_ratio": 43.2649224342571,
  "rank": 13,
  "total_validators": 68,
  "voting_power": 2.21080950841818,
  "nakamoto_coefficient": 5,
  "BFT_coefficient": 17,
  "delegators": 3513,
  "delegations_tokens": 3004036.588841,
  "delegations_USD": 1318696.96158648,
  "community_pool": 899921.659486916,
  "uptime": 0.999777777777778,
  "relayer_nonce": 0,
  "relayer_balance": 0,
  "blocks_made": 18077032,
  "self_stake": 6.2,
  "self_stake_percentage": 0.000002063603992569,
  "block_height": 17835070,
  "expected_blocktime": 5.80633411175667,
  "actual_blocktime": 5.8019319999218,
  "bonded_tokens": 135879858.161787,
  "not_bonded_tokens": 8544051.317319,
  "price": {
    "SCRT": {
      "usd": 0.438975,
      "usd_24h_vol": 4383468.92734058,
      "usd_24h_change": -1.86805447271059,
      "usd_market_cap": 130936636.330594,
      "circulating_supply": 298278116.81894,
      "usd_total_marketcap": 137338429.946066
    }
  },
  "circulating_supply": 298278116.81894,
  "unbonding_total": 1174927.153227,
  "unbonding_by_date": {
    "2025-01-11": 9244.065194,
    "2025-01-12": 24826.613614,
    "2025-01-13": 15496.209817,
    "2025-01-14": 37824.135437,
    "2025-01-15": 40118.894947,
    "2025-01-16": 15573.094463,
    "2025-01-17": 4936.200383,
    "2025-01-18": 132688.375936,
    "2025-01-19": 23663.063774,
    "2025-01-20": 42154.522372,
    "2025-01-21": 91628.51146,
    "2025-01-22": 161875.71293,
    "2025-01-23": 223285.706931,
    "2025-01-24": 28968.200646,
    "2025-01-25": 76623.359904,
    "2025-01-26": 33434.768132,
    "2025-01-27": 14102.503523,
    "2025-01-28": 132556.886346,
    "2025-01-29": 12141.650909,
    "2025-01-30": 47436.420448,
    "2025-01-31": 6340.646608,
    "2025-02-01": 7.609453
  },
  "total_ibc_balance_out": 3295586.361413,
  "total_ibc_sequence": 786763,
  "total_ibc_connections": 100,
  "total_ibc_channels": 183,
  "total_ibc_chains": 60,
  "validator_address": "secretvaloper1t5wtcuwjkdct9qkw2h6m48zu2hectpd6ulmekk",
  "commission": 0.05,
  "current_tvl": 14151818.8394723,
  "unique_wallets": 376408,
  "unique_contracts": null,
  "unique_codeID": 2119
}
Copy

#Historical Network Data

Get historical metrics for a network over time:

GET api.lavenderfive.com/network_history/{network}
Copy

The response includes several categories of historical data:

#Network Statistics History

"network_info": {
"2023-07-23 16:52:58": {
"total_validators_history": 80,
"voting_power_history": 1.57,
"nakamoto_coefficient_history": null,
"BFT_coefficient_history": null,
"bonded_ratio": null
}
// ... more timestamps
}
Copy

#Account Statistics History

"account_info": {
"2023-10-11 16:53:24": {
"unique_wallets": 313339,
"unique_contracts_history": 112057,
"unique_codeID": 1310
}
// ... more timestamps
}
Copy

#TVL History

"tvl_info": {
"2021-05-15": 47944771.88,
"2021-05-16": 48563512.91
// ... more dates
}
Copy

#IBC Statistics History

"ibc_info": {
"2024-05-09 20:18:06": {
"total_ibc_balance_out": 3169691.74,
"total_ibc_sequence": 646487,
"total_ibc_connections": 92,
"total_ibc_channels": 157,
"total_ibc_chains": 57
}
// ... more timestamps
}
Copy

#Unbonding History

"unbonding_info": {
"2023-08-24 00:09:57": {
"unbonding_total": 1505917.36
}
// ... more timestamps
}
Copy

#Usage Examples

#Python

import requests
# Get current network info
network = "secretnetwork"
response = requests.get(f"https://api.lavenderfive.com/networks/{network}")
network_data = response.json()

#Get historical data
history_response = requests.get(f"https://api.lavenderfive.com/network_history/{network}")
history_data = history_response.json()
Copy

#JavaScript

// Get current network info
const network = "secretnetwork";
fetch("https://api.lavenderfive.com/networks/${network}")
.then(response => response.json())
.then(data => console.log(data));
// Get historical data
fetch("https://api.lavenderfive.com/network_history/${network}")
.then(response => response.json())
.then(data => console.log(data));
Copy