GAgala
marketplace

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.

get/v1/marketplace/listings

Request

Query parameters

sellerstring
Example:client|61b7d20150874774e060edf9,eth|B48d99a6e64aD1766Eb111c807DbD210FdE3b4Ab

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.

searchunknown

Free-text match over name, collection and class key, e.g. birdhouse.

collectionunknown

Collection name, e.g. TownStar.

sort'recent' | 'price_asc' | 'price_desc'
limitunknown
Example:24

Page size (max 50).

pageunknown
Example:1

1-based page number.

Response

totalnumber required
pagenumber required
limitnumber required

Example response

{
  "items": [
    {
      "id": "native-synthetic-listing",
      "nftClass": "TownStar|Boost|Birdhouse|Rare",
      "instance": "1",
      "collection": "TownStar",
      "name": "TownStarBoostBirdhouseRare",
      "image": "https://tokens.gala.games/birdhouse.gif",
      "rarity": "Rare",
      "price": {
        "currency": "GALA",
        "amount": "100",
        "num": 100
      },
      "seller": "client|000000000000000000000000",
      "channel": "asset",
      "mode": "native",
      "bundleCount": 1,
      "expires": "0",
      "created": "1786000000000",
      "deepLink": "https://www.mercantorium.com/item/native-synthetic-listing"
    }
  ],
  "total": 30,
  "page": 1,
  "limit": 24
}

Changes

No recorded changes to this operation across all 1 revision of this API.