HTTP API reference › GalaSwap DEX › marketplace
GalaSwap DEX — marketplace
2 operations in this group.
- GET /v1/marketplace/listings — Browse active marketplace listings
- GET /v1/marketplace/listings/{id} — A single marketplace listing by id
GET /v1/marketplace/listings
MarketplaceController_getListings
Browse active marketplace listings
Merges the asset-channel feed with the cross-channel (brokered) one, so game inventory such as VOX, Mirandus and Node appears alongside asset-channel items. Filtering, sorting and pagination are applied server-side over the merged set.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| seller | query | optional | Comma-separated seller aliases; a listing matching ANY of them is returned. Send both the `eth|…` and `client|…` forms of a wallet — upstream records sellers under either, so a single form silently returns nothing. | |
| search | query | optional | Free-text match over name, collection and class key, e.g. `birdhouse`. | |
| collection | query | optional | Collection name, e.g. `TownStar`. | |
| sort | query | optional | string enum: recent, price_asc, price_desc | |
| limit | query | optional | Page size (max 50). | |
| page | query | optional | 1-based page number. |
Responses
200 —
Content type: application/json
Schema: MarketplaceListingPageResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| items | array<MarketplaceListingResponseDto> | yes | |
| total | number | yes | |
| page | number | yes | |
| limit | number | yes |
400 —
Content type: application/json
Schema: MarketplaceErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| status | boolean | yes | |
| message | string | yes |
404 —
Content type: application/json
Schema: MarketplaceHttpErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| statusCode | number | yes | |
| message | string | yes | |
| error | string | yes |
502 —
Content type: application/json
Schema: MarketplaceErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| status | boolean | yes | |
| message | string | yes |
503 —
Content type: application/json
Schema: MarketplaceRateLimitResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| status | boolean | yes | |
| message | string | yes | |
| retryAfter | number | yes |
default — An error response using the shared backend error envelope.
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| status | integer | yes | |
| error | boolean | yes | |
| message | string | yes | |
| errorKey | string | no |
Example response
[]
GET /v1/marketplace/listings/{id}
MarketplaceController_getListing
A single marketplace listing by id
A single marketplace listing by id
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | The listing's URL-safe handle. |
Responses
200 —
Content type: application/json
Schema: MarketplaceListingResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| id | string | yes | |
| nftClass | string nullable | yes | |
| instance | string nullable | yes | |
| collection | string nullable | yes | |
| name | string nullable | yes | |
| image | string nullable | yes | |
| rarity | string nullable | yes | |
| price | MarketplacePriceResponseDto | yes | |
| seller | string | yes | |
| channel | string | yes | |
| mode | string enum: native, brokered | yes | |
| bundleCount | number | yes | |
| expires | string | yes | |
| created | string | yes | |
| deepLink | string (uri) | yes |
400 —
Content type: application/json
Schema: MarketplaceHttpErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| statusCode | number | yes | |
| message | string | yes | |
| error | string | yes |
404 —
Content type: application/json
Schema: oneOf: MarketplaceErrorResponseDto | MarketplaceHttpErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| status | boolean | yes | |
| message | string | yes | |
| statusCode | number | yes | |
| message | string | yes | |
| error | string | yes |
503 —
Content type: application/json
Schema: MarketplaceRateLimitResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| status | boolean | yes | |
| message | string | yes | |
| retryAfter | number | yes |
default — An error response using the shared backend error envelope.
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| status | integer | yes | |
| error | boolean | yes | |
| message | string | yes | |
| errorKey | string | no |
Example response
[]
Previous group: market · Next group: ExtensionVersion