> ## 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 Commodities

> Browse the commodity catalog (items, tools, skins)

<ParamField query="type" type="string">Filter: `ITEM`, `TOOL`, or `SKIN`</ParamField>
<ParamField query="itemCode" type="string">Filter by exact item code</ParamField>
<ParamField query="category" type="string">Filter by category (e.g. `Health`, `Battle`, `Farming`)</ParamField>
<ParamField query="rarity" type="string">Filter by rarity (e.g. `Common`, `Rare`, `Epic`)</ParamField>
<ParamField query="tradable" type="string" default="true">`true`, `false`, or `all`</ParamField>
<ParamField query="search" type="string">Text search on name or code</ParamField>
<ParamField query="page" type="number" default="1">Page number</ParamField>
<ParamField query="limit" type="number" default="50">Results per page (max 200)</ParamField>
<ParamField query="sortBy" type="string" default="name_asc">`name_asc`, `name_desc`, `code_asc`, or `code_desc`</ParamField>

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

### Response Fields

| Field                      | Description                                                  |
| -------------------------- | ------------------------------------------------------------ |
| commodities\[].code        | Item code                                                    |
| commodities\[].name        | Display name                                                 |
| commodities\[].type        | `ITEM`, `TOOL`, or `SKIN`                                    |
| commodities\[].category    | Item category (if applicable)                                |
| commodities\[].rarity      | Item rarity (if applicable)                                  |
| commodities\[].iconUrl     | URL to item icon image                                       |
| commodities\[].description | Item description                                             |
| commodities\[].tradable    | Whether the item is tradable                                 |
| pagination                 | Page info (page, limit, total, totalPages, hasNext, hasPrev) |