List Token Holders

Retrieve all holders of a specific stock token

GET /stocks/api/fetch/holders/{tokenAddress}

cURL

curl "https://api.trusset.org/stocks/api/fetch/holders/0x1234...?limit=50" \
  -H "X-API-Key: trusset_abc123xy_secret..."

Response

{
  "success": true,
  "data": {
    "holders": [
      {
        "address": "0xAbC123dEf456789012345678901234567890AbCd",
        "balance": "5000"
      },
      {
        "address": "0x9876543210fedcba9876543210fedcba98765432",
        "balance": "1500"
      }
    ],
    "total": 2
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z",
    "instanceId": "inst_abc123"
  }
}

Returns a paginated list of addresses holding a given stock token, along with the total holder count.

Path Parameters

tokenAddress · string · required

Address of the stock token contract.

Query Parameters

limit · integer · default: "100"

Maximum number of holders to return. Capped at 500.

Response Fields

success · boolean

Request status.

data · object

Show child attributes

holders · object[]

Array of holder records.

total · integer

Total number of holders for this token.

cURL

curl "https://api.trusset.org/stocks/api/fetch/holders/0x1234...?limit=50" \
  -H "X-API-Key: trusset_abc123xy_secret..."

Response

{
  "success": true,
  "data": {
    "holders": [
      {
        "address": "0xAbC123dEf456789012345678901234567890AbCd",
        "balance": "5000"
      },
      {
        "address": "0x9876543210fedcba9876543210fedcba98765432",
        "balance": "1500"
      }
    ],
    "total": 2
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z",
    "instanceId": "inst_abc123"
  }
}