OFFCHAIN-MARKETPLACE

Search and browse marketplace listings

Searches active marketplace listings with support for filtering by type (Zee/Items), price range. Results can be sorted by price or creation date. Returns paginated results with seller information and item metadata. The volume field contains lifetime sold volume (in wei) grouped by listing type.

get/v2/offchain-marketplace

Request

  • Base URL: https://api.zee-verse.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.zee-verse.com/v2/offchain-marketplace
  • Auth: HTTP bearer

Query parameters

typestring[]

Filter by one or more listing types

[
  "zee",
  "items"
]
evolutionnumber[]

Filter by one or more evolution levels

[
  1,
  2
]
zeeTypestring[]

Filter by one or more ZEE types

[
  "fire",
  "water"
]
visualstring[]

Filter ZEE listings by one or more visuals

[
  "Zoomba",
  "Taka"
]
itemIdstring[]

Filter item listings by one or more item token ids

[
  "1",
  "42"
]
levelnumber[]

Filter by one or more levels

[
  1,
  10
]
trait1string[]

Filter by one or more values for the first creature trait slot

[
  "damage",
  "speed"
]
trait2string[]

Filter by one or more values for the second creature trait slot

[
  "defense"
]
trait3string[]

Filter by one or more values for the third creature trait slot

[
  "critical"
]
trait4string[]

Filter by one or more values for the fourth creature trait slot

[
  "hitpoints"
]
minPricestring

Minimum price in offchain VEE (wei)

Example:1000000000000000000
maxPricestring

Maximum price in offchain VEE (wei)

Example:10000000000000000000
querystring

Search keyword to find listings by name or attributes

Example:Metal Axe, Axe
excludeOwnListingsboolean

Exclude listings created by the authenticated user

Example:true
sortBy'price_asc' | 'price_desc' | 'created_desc'

Sort order for results

Example:price_asc
pagenumber

Page number for pagination

Example:1
perPagenumber

Number of items per page

Example:20
showAllboolean

Return every active item listing without deduping by token id (default returns only the cheapest per item). Pass ?showAll (no value) or ?showAll=true to enable.

Example:true

Response

Example response

{
  "volume": {
    "zee": "3000000000000000000",
    "items": "500000000000000000"
  },
  "data": [
    {
      "seller": {
        "id": "550e8400-e29b-41d4-a716-446655440001",
        "username": "John Doe",
        "avatar": "https://example.com/avatar.jpg"
      },
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "zee",
      "metadata": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "itemId": "2100420103",
        "name": "My Awesome Item",
        "type": "fire",
        "visual": "Zoomba"
      },
      "amount": 1,
      "price": "1000000000000000000",
      "stats": {
        "priceChange1h": -0.01,
        "priceChange24h": -0.01,
        "priceChange7d": -0.01,
        "volume": {
          "buy": "1000000000000000000",
          "sell": "1000000000000000000"
        }
      }
    }
  ]
}

Changes

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