HTTP API reference › Gala Launchpad › trade
Gala Launchpad — trade
2 operations in this group.
- GET /v1/tokens/{tokenName}/trades — Get trade history
- GET /v1/trades — Query trades
GET /v1/tokens/{tokenName}/trades
TradeController_getTradeRecords
Get trade history
Get paginated trade history for a token
token name
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| tokenName | path | required | string | |
| tokenName | query | optional | string | Ignored; tokenName is resolved from the path. |
| cursor | query | optional | string | Cursor from previous response for pagination. Omit for first page. |
| pageSize | query | optional | number | Number of items per page (default: 50, max: 1000) |
| search | query | optional | string | Search query string |
| sortBy | query | optional | string | Field to sort by (must be in allowed list) |
| sortOrder | query | optional | string enum: ASC, DESC | Sort order (default: DESC) |
Responses
200 — Cursor-paginated trade history.
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 | TradeHistoryResponseDto | yes |
400 — Bad request - tokenName missing or invalid, or skip/limit parameters invalid
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 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 - database query failed
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 trade history 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/trades
PlatformTradesController_getTrades
Query trades
Query trades with flexible filtering by token or user address
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| maxAmount | query | optional | number | |
| minAmount | query | optional | number | |
| endDate | query | optional | string (date-time) | |
| startDate | query | optional | string (date-time) | |
| txnType | query | optional | string enum: BUY, SELL | |
| userAddress | query | optional | string | |
| tokenName | query | optional | string | |
| cursor | query | optional | string | Cursor from previous response for pagination. Omit for first page. |
| pageSize | query | optional | number | Number of items per page (default: 50, max: 1000) |
| search | query | optional | string | Search query string |
| sortBy | query | optional | string | Field to sort by (must be in allowed list) |
| sortOrder | query | optional | string enum: ASC, DESC | Sort order (default: DESC) |
Responses
200 — Filtered cursor-paginated trade history.
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 | TradeHistoryResponseDto | yes |
400 — Bad request - either tokenName or userAddress must be provided, invalid txnType, invalid dates, or skip/limit invalid
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 - database query failed
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 trade query 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: simulcasts · Next group: trading