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

# Batch Prices

> Get floor prices, best offers, and average sale prices for multiple commodities in a single request

<Note>Requires `x-api-token` header. Maximum 50 items per request.</Note>

### Request Body

```json theme={null}
{
  "commodities": {
    "ITEM": ["oKjVsSwr", "KJepBrme"],
    "TOOL": ["skateboard"]
  }
}
```

<ParamField body="commodities" type="object" required>
  Object with commodity types as keys (`ITEM`, `TOOL`, `SKIN`) and arrays of item codes as values.
</ParamField>

### Response Fields

| Field                   | Description                           |
| ----------------------- | ------------------------------------- |
| prices                  | Object keyed by `TYPE:itemCode`       |
| prices\[].lowestListing | Current floor price (BORNE)           |
| prices\[].highestOffer  | Highest active offer per unit (BORNE) |
| prices\[].avgPrice24h   | Average sale price over last 24 hours |
| prices\[].avgPrice7d    | Average sale price over last 7 days   |
| prices\[].avgPrice30d   | Average sale price over last 30 days  |

### Example Response

```json theme={null}
{
  "prices": {
    "ITEM:oKjVsSwr": {
      "lowestListing": 12.0,
      "highestOffer": 14.5,
      "avgPrice24h": 15.2,
      "avgPrice7d": 13.1,
      "avgPrice30d": 14.0
    },
    "ITEM:KJepBrme": {
      "lowestListing": 8.0,
      "highestOffer": 10.0,
      "avgPrice24h": 9.5,
      "avgPrice7d": null,
      "avgPrice30d": null
    },
    "TOOL:skateboard": {
      "lowestListing": 50.0,
      "highestOffer": null,
      "avgPrice24h": null,
      "avgPrice7d": 48.0,
      "avgPrice30d": 45.0
    }
  }
}
```