> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spellborne.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Bazaar Listings

> Get active sell orders for items, skins, and tools

<ParamField query="page" type="number" default="1">Page number</ParamField>
<ParamField query="limit" type="number" default="50">Results per page (max 100)</ParamField>
<ParamField query="itemCode" type="string">Filter by item code</ParamField>
<ParamField query="commodityType" type="string">Filter: `ITEM`, `TOOL`, `SKIN`, or `FURNITURE`</ParamField>
<ParamField query="minPrice" type="number">Minimum price</ParamField>
<ParamField query="maxPrice" type="number">Maximum price</ParamField>
<ParamField query="sortBy" type="string" default="createdAt">Sort field: `createdAt`, `perItemPrice`, or `amount`</ParamField>
<ParamField query="sortOrder" type="string" default="desc">`asc` or `desc`</ParamField>

<Note>Requires `x-api-token` header.</Note>

### Response Fields

| Field                               | Description                            |
| ----------------------------------- | -------------------------------------- |
| listings\[].itemCode                | Item code                              |
| listings\[].itemName                | Translated item name                   |
| listings\[].amount                  | Quantity listed                        |
| listings\[].price                   | Total listing price (BORNE)            |
| listings\[].perItemPrice            | Price per unit (BORNE)                 |
| listings\[].seller                  | Seller info (username, equippedOutfit) |
| pagination                          | Page info                              |
| aggregatedStats.count               | Total number of matching listings      |
| aggregatedStats.totalVolume         | Sum of all listing prices (BORNE)      |
| aggregatedStats.avgPricePerUnit     | Average per-unit price                 |
| aggregatedStats.highestPricePerUnit | Highest per-unit price                 |
| aggregatedStats.lowestPricePerUnit  | Lowest per-unit price                  |