Skip to content
GET /v1/holders

Who holds a creator's coin, by coins held

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/deso-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/deso-api/v1/holders" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/deso-api/v1/holders", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/deso-api/v1/holders");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/deso-api/v1/holders",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "Who holds this creator's coin — on DeSo every profile has a 'creator coin' that fans can buy, so its holders are the people invested in this creator. Each holder shows the coins they hold (in the creator's coin units) and their DeSo balance; sorted by coins held. Pass username and limit (1-100).",
        "count": 20,
        "source": "DeSo",
        "holders": [
            {
                "holder": "meepmeep",
                "coins_held": 28.3118,
                "has_purchased": true,
                "holder_public_key": "BC1YLgtPj6g7ZdKSmHvLpf9apwn8VozD5iKxHkWedR9Dmw7DMedqCKP",
                "holder_deso_balance": 1.0203
            },
            {
                "holder": "grond",
                "coins_held": 20.0271,
                "has_purchased": true,
                "holder_public_key": "BC1YLgLu3J4EUf7xXZ2KmT332tLboPxXZS8cE4wJY7ifx8Ccsc9dPxW",
                "holder_deso_balance": 6.472
            },
            {
                "holder": "PremierNS",
                "coins_held": 19.7164,
                "has_purchased": true,
                "holder_public_key": "BC1YLhFvNUGvWUUeXaJKkgugMomRNrVCVjjgsubabwCLRW2P9uorkNi",
                "holder_deso_balance": 1.8088
            },
            {
                "holder": "nader",
                "coins_held": 5.7018,
                "has_purchased": true,
                "holder_public_key": "BC1YLhyuDGeWVgHmh3UQEoKstda525T1LnonYWURBdpgWbFBfRuntP5",
                "holder_deso_balance": 2237.5047
            },
            {
                "holder": "Ballerina",
                "coins_held": 4.4108,
                "has_purchased": true,
                "holder_public_key": "BC1YLjLRKSRRZXh96pFC3uYb2zwfWgoyoackNvQdnrVeggwYNxCLgNZ",
                "holder_deso_balance": 730.6076
            },
            {
                "holder": null,
                "coins_held": 2.0629,
                "has_purchased": true,
                "holder_public_key": "BC1YLgKSjH8ZtdgAnLDuXub6UAXU7L4oCv1myMXfVY9dpCu2DXLS2As",
                "holder_deso_balance": 141.4967
            },
            {
                "holder": "SFW3",
                "coins_held": 1.6364,
                "has_purchased": true,
                "holder_public_key": "BC1YLj18JbmNCvfWakHr1UNGzR1VLSgh5jPqBEht4cBTB6kfbwRxCdL",
                "holder_deso_balance": 1.0177
            },
            {
                "holder": "stantontv",
                "coins_held": 1.0695,
                "has_purchased": true,
                "holder_public_key": "BC1YLfks9eXeMQa9RPVZHu4HE8syBk3t5SUfKBRq9ehp8ccmS8N6arC",
                "holder_deso_balance": 3023.194
            },
            {
                "holder": "0xAustin",
                "coins_held": 1.0392,
                "has_purchased": true,
                "holder_public_key": "BC1YLieLEL8yqLAebpqqA44fXtobriuuVMi6vA6BsRCxAFndizxeoN3",
                "holder_deso_balance": 1036.4452
            },
            {
           
…