Retrieve the holders of a token

POST 
https://minatokens.com/api/v1//info/holders

The holders endpoint retrieves the holders of a token.

Request

application/json

Bodyrequired

addressstringrequired

The Mina address for which to retrieve the holders

Responses

200

Successful retrieval of token holders.

application/json

Schema

Schema

holders object[]required
Array of token holders and their balances
Array [
addressstringrequired
The address of the token holder
balancenumberrequired
The total token balance held by this address
percentagenumberrequired
The percentage of total token supply held by this address
isZkappAccountbooleanrequired
Whether this holder is a zkApp account
]

Example (auto)

{
  "holders": [
    {
      "address": "string",
      "balance": 0,
      "percentage": 0,
      "isZkappAccount": true
    }
  ]
}

400

Bad request - invalid input parameters.

application/json

Schema

Schema

errorstring

Error message detailing the issue.

Example (auto)

{
  "error": "string"
}

401

Unauthorized - user not authenticated.

application/json

Schema

Schema

errorstring

Error message detailing the issue.

Example (auto)

{
  "error": "string"
}

403

Forbidden - user doesn't have permission.

application/json

Schema

Schema

errorstring

Error message detailing the issue.

Example (auto)

{
  "error": "string"
}

429

Too many requests.

application/json

Schema

Schema

errorstring

Error message detailing the issue.

Example (auto)

{
  "error": "string"
}

500

Internal server error - something went wrong during the request.

application/json

Schema

Schema

errorstring

Error message detailing the issue.

Example (auto)

{
  "error": "string"
}

503

Service unavailable - blockchain or other external service is down.

application/json

Schema

Schema

errorstring

Error message detailing the issue.

Example (auto)

{
  "error": "string"
}

Authorization: x-api-key

name: x-api-keytype: apiKeyin: headerdescription: API key for authorization. Get your API key at https://minatokens.com/api

• curl
• javascript
• nodejs
• python
• rust
• ocaml
• go
• java
• powershell

• CURL

curl -L 'https://minatokens.com/api/v1/info/holders' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'x-api-key: <x-api-key>' \
-d '{
  "address": "string"
}'

Request Collapse all

Base URL

https://minatokens.com/api/v1

Auth

ApiKeyAuth

Body required

• Example (from schema)
• getTokenHoldersRequest

{
  "address": "string"
}

ResponseClear

Click the Send API Request button above and see the response here!