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

> Get historical bazaar sales data with per-unit pricing

<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`, `SKIN`, or `TOOL`</ParamField>
<ParamField query="period" type="string" default="7d">`24h`, `7d`, `30d`, `6m`, or `all`</ParamField>
<ParamField query="since" type="string">Start date (ISO string or unix timestamp)</ParamField>
<ParamField query="until" type="string">End date (ISO string or unix timestamp)</ParamField>
<ParamField query="minPrice" type="number">Minimum price</ParamField>
<ParamField query="maxPrice" type="number">Maximum price</ParamField>
<ParamField query="filterStatus" type="string" default="completed">Sale status filter</ParamField>
<ParamField query="filterToken" type="string">Filter by payment token (e.g. `BORNE`)</ParamField>
<ParamField query="wallet" type="string">Filter by wallet address — returns trades where the wallet was buyer or seller</ParamField>

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

### Response Fields

| Field                  | Description                                                                                                                               |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| sales                  | Array of sale records                                                                                                                     |
| sales\[].totalPrice    | Total sale price (BORNE)                                                                                                                  |
| sales\[].pricePerUnit  | Price per single item (BORNE)                                                                                                             |
| sales\[].amount        | Quantity sold                                                                                                                             |
| sales\[].txHash        | On-chain transaction hash                                                                                                                 |
| sales\[].buyerAddress  | Buyer wallet address                                                                                                                      |
| sales\[].sellerAddress | Seller wallet address                                                                                                                     |
| pagination             | Page info (page, limit, total, totalPages, hasNext, hasPrev)                                                                              |
| stats.avgPrice         | Average per-unit price across filtered sales                                                                                              |
| stats.minPrice         | Lowest per-unit sale price                                                                                                                |
| stats.maxPrice         | Highest per-unit sale price                                                                                                               |
| stats.totalVolume      | Total volume (BORNE)                                                                                                                      |
| stats.salesCount       | Number of sales                                                                                                                           |
| priceChanges           | Floor price changes for 24h, 7d, 30d, 6m windows (only when `itemCode` is specified). Uses floor price snapshots to match in-game values. |