HTTP API reference › Gala Launchpad › holders
Gala Launchpad — holders
1 operation in this group.
- GET /v1/holders — Get token holders with query filtering
GET /v1/holders
HolderController_getHolders
Get token holders with query filtering
Get top token holders or specific user holder data using query parameters
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| pageSize | query | optional | Maximum number of holders to return (1-100, default 10) | |
| userAddress | query | optional | Specific user address to get holder data for | |
| tokenName | query | required | Token name to query holders for |
Responses
200 — Holder data retrieved successfully - returns array of top holders or specific user data
Content type: application/json
Schema: oneOf: HolderListSuccessEnvelopeDto | UserHolderSuccessEnvelopeDto
| Field | Type | Required | Description |
|---|---|---|---|
| data | array<HolderItemResponseDto> | yes | |
| error | boolean enum: false | yes | |
| message | string | yes | |
| status | number | yes | |
| data | UserHolderResponseDto | yes | |
| error | boolean enum: false | yes | |
| message | string | yes | |
| status | number | yes |
400 — Bad request - invalid query parameters or tokenName format
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| error | boolean enum: true | yes | |
| message | oneOf: string | array<string> | yes | |
| status | integer | yes | HTTP status code. |
| message | string | yes | |
| statusCode | integer | yes | HTTP status code. |
404 — Token not found - tokenName does not match any existing pool
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| error | boolean enum: true | yes | |
| message | oneOf: string | array<string> | yes | |
| status | integer | yes | HTTP status code. |
| message | string | yes | |
| statusCode | integer | yes | HTTP status code. |
500 — Internal server error - failed to retrieve holder data from blockchain or cache
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| error | boolean enum: true | yes | |
| message | oneOf: string | array<string> | yes | |
| status | integer | yes | HTTP status code. |
| message | string | yes | |
| statusCode | integer | yes | HTTP status code. |
default — Shared error envelope for token lookup and holder service failures.
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| error | boolean enum: true | yes | |
| message | oneOf: string | array<string> | yes | |
| status | integer | yes | HTTP status code. |
| message | string | yes | |
| statusCode | integer | yes | HTTP status code. |
Example response
[]
Previous group: Events · Next group: moderated-tokens