Get holder balance

Retrieves holder balance for a specific Rune.

GET
/runes/v1/etchings/{etching}/holders/{address}

Path Parameters

etchingRune ID & Rune number & Rune name & Rune name with spacers
addressAddress

Bitcoin address

Response Body

Default Response

TypeScript Definitions

Use the response body type in TypeScript.

address?Address

Bitcoin address which holds this balance

balanceBalance

Rune balance

Default Response

TypeScript Definitions

Use the response body type in TypeScript.

errorstring
Value in"Not found"
curl -X GET "https://api.hiro.so//runes/v1/etchings/string/holders/bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5"
fetch("https://api.hiro.so//runes/v1/etchings/string/holders/bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5")
package main

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

func main() {
  url := "https://api.hiro.so//runes/v1/etchings/string/holders/bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5"

  req, _ := http.NewRequest("GET", url, nil)
  
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://api.hiro.so//runes/v1/etchings/string/holders/bc1p8aq8s3z9xl87e74twfk93mljxq6alv4a79yheadx33t9np4g2wkqqt8kc5"

response = requests.request("GET", url)

print(response.text)
{
  "address": "bc1q7jd477wc5s88hsvenr0ddtatsw282hfjzg59wz",
  "balance": "11000000000"
}
{
  "error": "Not found"
}