Balance API

API KEY

Access to the RPC data requires authentication. Head to the Developer Portal to get your API Key.

Use this endpoint to fetch the balance of a given address.

Base URL

Shibarium

https://chain.shib.io/api/v1/shibarium

Puppynet

https://chain.shib.io/api/v1/puppynet

Request example

  GET  /balance

cURL

curl -s "https://chain.shib.io/api/v1/puppynet/balance?address={{address}}&api_key={{api_key}}" \
 -H "Content-Type: application/json" -X GET

Typescript

// Get transactions
fetch('https://chain.shib.io/api/v1/puppynet/transactions?address=<wallet_address>&api_key=<api_key>', {
  headers: { 'Content-Type': 'application/json' }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

// Get balances
fetch('https://chain.shib.io/api/v1/puppynet/balances?address=<wallet_address>&api_key=<api_key>', {
  headers: { 'Content-Type': 'application/json' }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

Go

package main

import (
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	// Get transactions
	transactionsResp, _ := http.Get("https://chain.shib.io/api/v1/puppynet/transactions?address=<wallet_address>&api_key=<api_key>")
	transactions, _ := ioutil.ReadAll(transactionsResp.Body)
	fmt.Println(string(transactions))

	// Get balances
	balancesResp, _ := http.Get("https://chain.shib.io/api/v1/puppynet/balances?address=<wallet_address>&api_key=<api_key>")
	balances, _ := ioutil.ReadAll(balancesResp.Body)
	fmt.Println(string(balances))
}

Header Parameters

No header parameters needed.

Query Parameters

Parameter	Type	Description	Required
api_key	string	Your API key provided by the Developer Portal.	YES
address	string	The wallet address from which you would like to fetch data.	YES

Response

{
  "items": [
    {
      "token": {
        "address": "0xf010f12dcA0b96D2d6685bf4dB3dbB4Ad500B6Ad",
        "circulating_market_cap": null,
        "decimals": "6",
        "exchange_rate": null,
        "holders": "59",
        "icon_url": null,
        "name": "USD Coin",
        "symbol": "USDC",
        "total_supply": "18300718155",
        "type": "ERC-20",
        "volume_24h": null
      },
      "token_id": null,
      "token_instance": null,
      "value": "100000"
    }
  ],
  "next_page_params": null
}

Key	Value
items	List of tokens.
token	Describes the specific token (e.g., USDC) held by the address.
address	The contract address of the token.
circulating_market_cap	Market capitalization of the circulating supply of the token (if available).
decimals	Number of decimal places the token supports.
exchange_rate	Token's exchange rate (if available).
holders	Number of addresses holding the token.
icon_url	URL to the token's icon or logo.
name	The token's full name.
symbol	The token's ticker symbol (e.g., USDC).
total_supply	The total number of tokens in circulation.
type	The token's standard (e.g., ERC-20 for fungible tokens).
volume_24h	The 24-hour trading volume of the token (if available).
token_id	Token ID for NFTs or non-fungible tokens.
token_instance	Instance details for non-fungible tokens .
value	The balance of the queried address in the specified token.
next_page_params	Indicates pagination details if more token balances are available