BTNS API - Holders BTNS API
Method Endpoint Returns
GET /api/holders/{token} Returns list of holders of an token
Return Values
Value Type Description
data Array Holder data
address String Bitcoin address
value Object Estimated value
     btc String Estimated value in Bitcoin (BTC)
     usd String Estimated value in US Dollars (USD)
amount String Amount of token held
percent String Percentage of total supply
tick String Token name (Ex: PIZZA)
total Integer Total number of holders
Example Response
{
    "data": [{
            "address": "bc1q0dwc8wkn7q24dkax3pfyylqsydvr3ppc3krrht",
            "amount": "16",
            "percent": "33.33333333%",
            "value": {
                "btc": "0.00197440",
                "usd": "55.30"
            }
        },
        {
            "address": "bc1q4kv96a03gml49mlwjktcrjl4d4xk7j5wj3gewf",
            "amount": "8",
            "percent": "16.66666667%",
            "value": {
                "btc": "0.00098720",
                "usd": "27.65"
            }
        },
        {
            "address": "bc1qd0rnw59tfevr9yufmjdygssqjvvqvfz90eg8nn",
            "amount": "8",
            "percent": "16.66666667%",
            "value": {
                "btc": "0.00098720",
                "usd": "27.65"
            }
        },
        {
            "address": "1GRsNGBQVCEWFtb83sXoUDqCrCo7n1bHCk",
            "amount": "6",
            "percent": "12.50000000%",
            "value": {
                "btc": "0.00074040",
                "usd": "20.74"
            }
        },
        {
            "address": "bc1qqcy48e2jhl7q9vyjsujlsegk3r8warwldjs9g0",
            "amount": "5",
            "percent": "10.41666667%",
            "value": {
                "btc": "0.00061700",
                "usd": "17.28"
            }
        },
        {
            "address": "bc1q2uwat3ud94w8u54lhqyflqfyccc9tn02gy8vpc",
            "amount": "2",
            "percent": "4.16666667%",
            "value": {
                "btc": "0.00024680",
                "usd": "6.91"
            }
        },
        {
            "address": "bc1qrx72afxl8c6dx53ahswpmwf58v3wp3pae54j9w",
            "amount": "2",
            "percent": "4.16666667%",
            "value": {
                "btc": "0.00024680",
                "usd": "6.91"
            }
        },
        {
            "address": "bc1qjamrqt99cwrmkcg8snhl25qjqduk24dkw56u5t",
            "amount": "1",
            "percent": "2.08333333%",
            "value": {
                "btc": "0.00012340",
                "usd": "3.46"
            }
        }
    ],
    "tick": "X",
    "total": 8
}