HTTP API reference › Gala Launchpad › Tokens
Gala Launchpad — Tokens
7 operations in this group.
- GET /v1/tokens — List all tokens
- POST /v1/tokens — Create a new token on the bonding curve
- GET /v1/tokens/{tokenName} — Get token details
- PATCH /v1/tokens/{tokenName} — Update token configuration
- POST /v1/tokens/{tokenName}/image — Upload token image
- GET /v1/tokens/{tokenName}/role — Get user role for a token
- GET /v1/tokens/{tokenName}/stats — Get token stats
GET /v1/tokens
TokensController_listTokens
List all tokens
List all tokens
Responses
200 — Token results and cursor metadata; tokens is an object for a tokenName query and otherwise an array.
Content type: application/json
Schema: ApiSuccessEnvelopeMetadataDto & object
| Field | Type | Required | Description |
|---|---|---|---|
| error | boolean enum: false | yes | Successful response marker. |
| message | string | yes | Response message. |
| status | number | yes | HTTP status code. |
| data | TokenListResponseDto | yes |
default — Shared error envelope for token list 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
[]
POST /v1/tokens
TokensController_createToken
Create a new token on the bonding curve
Create a new token on the bonding curve
Authentication: apiKeyAuth, bearer
api key auth
Request body
Required: yes
application/json
Schema: RegisterPoolDto
| Field | Type | Required | Description |
|---|---|---|---|
| amount | string | yes | |
| blockNumber | number | yes | |
| description | string | yes | |
| facebookUrl | string | no | |
| image | string (uri) | yes | |
| initialBuyQuantity | string | yes | |
| instagramUrl | string | no | |
| outputAmount | string | no | |
| redditUrl | string | no | |
| reverseBondingCurveConfiguration | ReverseBondingCurveConfigurationDto | no | |
| saleStartTime | number | no | |
| symbol | string | yes | |
| telegramUrl | string | no | |
| tiktokUrl | string | no | |
| tokenName | string | yes | |
| twitterUrl | string | no | |
| txnId | string | yes | |
| urls | object | yes | |
| vaultAddress | string | yes | |
| websiteUrl | string | no |
Responses
201 — Token was created; the success envelope omits data.
Content type: application/json
Schema: ApiSuccessEnvelopeMetadataDto
| Field | Type | Required | Description |
|---|---|---|---|
| error | boolean enum: false | yes | Successful response marker. |
| message | string | yes | Response message. |
| status | number | yes | HTTP status code. |
400 — Invalid token configuration
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. |
401 — Unauthorized
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. |
403 — Forbidden
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 creation 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 request
[]
Example response
[]
GET /v1/tokens/{tokenName}
TokensController_getToken
Get token details
Get token details
token name
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| tokenName | path | required | string | Token name resolved to a platform pool. |
Responses
200 — Token details with cursor metadata.
Content type: application/json
Schema: ApiSuccessEnvelopeMetadataDto & object
| Field | Type | Required | Description |
|---|---|---|---|
| error | boolean enum: false | yes | Successful response marker. |
| message | string | yes | Response message. |
| status | number | yes | HTTP status code. |
| data | TokenDetailsResponseDto | yes |
404 — Token not found
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 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
[]
PATCH /v1/tokens/{tokenName}
TokensController_updateTokenConfig
Update token configuration
Update token configuration
Authentication: apiKeyAuth, bearer
token name api key auth
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| tokenName | path | required | string | Token name resolved to a platform pool. |
Request body
Required: yes
application/json
Schema: UpdateTokenConfigDto
| Field | Type | Required | Description |
|---|---|---|---|
| chatEnabled | boolean | no | |
| commentsEnabled | boolean | no | |
| facebookUrl | string nullable | no | |
| instagramUrl | string nullable | no | |
| nextLiveStreamAt | string (date-time) nullable | no | |
| redditUrl | string nullable | no | |
| streamingEnabled | boolean | no | |
| streamLanguage | string | no | |
| telegramUrl | string nullable | no | |
| tiktokUrl | string nullable | no | |
| twitterUrl | string nullable | no | |
| websiteUrl | string nullable | no |
Responses
200 — Updated token pool record.
Content type: application/json
Schema: ApiSuccessEnvelopeMetadataDto & object
| Field | Type | Required | Description |
|---|---|---|---|
| error | boolean enum: false | yes | Successful response marker. |
| message | string | yes | Response message. |
| status | number | yes | HTTP status code. |
| data | TokenPoolRecordResponseDto | yes |
403 — Forbidden
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 configuration 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 request
[]
Example response
[]
POST /v1/tokens/{tokenName}/image
TokensController_uploadImage
Upload token image
Upload token image
Authentication: apiKeyAuth, bearer
token name api key auth
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| tokenName | path | required | string | Token name used to scope the uploaded image. |
Request body
Required: yes
multipart/form-data
Schema: object
| Field | Type | Required | Description |
|---|---|---|---|
| image | string (binary) | yes |
Responses
200 — Uploaded image URL.
Content type: application/json
Schema: ApiSuccessEnvelopeMetadataDto & object
| Field | Type | Required | Description |
|---|---|---|---|
| error | boolean enum: false | yes | Successful response marker. |
| message | string | yes | Response message. |
| status | number | yes | HTTP status code. |
| data | string (uri) | yes |
400 — Invalid file format or size
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. |
401 — Unauthorized
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. |
403 — Forbidden - token owner only
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 image upload 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 request
[]
Example response
[]
GET /v1/tokens/{tokenName}/role
TokensController_getUserRole
Get user role for a token
Get user role for a token
Authentication: apiKeyAuth, bearer
token name api key auth
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| tokenName | path | required | string | Token name resolved to a platform pool. |
Responses
200 — Effective user role and access source for the token.
Content type: application/json
Schema: ApiSuccessEnvelopeMetadataDto & object
| Field | Type | Required | Description |
|---|---|---|---|
| error | boolean enum: false | yes | Successful response marker. |
| message | string | yes | Response message. |
| status | number | yes | HTTP status code. |
| data | UserRoleResponse | yes |
401 — Unauthorized - missing or invalid JWT token
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
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 role 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
[]
GET /v1/tokens/{tokenName}/stats
TokensController_getTokenStats
Get token stats
Get token stats
token name
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| tokenName | path | required | string | Token name resolved to a platform pool. |
Responses
200 — Holder, chat, comment, and connected-room counts.
Content type: application/json
Schema: ApiSuccessEnvelopeMetadataDto & object
| Field | Type | Required | Description |
|---|---|---|---|
| error | boolean enum: false | yes | Successful response marker. |
| message | string | yes | Response message. |
| status | number | yes | HTTP status code. |
| data | TokenStatsResponse | yes |
404 — Token not found
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 statistics 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: token-bans · Next group: Token Active Users