> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cs2cap.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Field Reference: All Response Fields
> Complete definitions for every field returned by the CS2Cap API, including price fields, pagination, the response envelope, and item catalog metadata.
Every CS2Cap endpoint returns a predictable set of fields. This reference covers what each field means, its type, which endpoints return it, and any important formatting rules you need to follow when reading values — especially the minor-units convention for all price data.
All price fields (`lowest_ask`, `highest_bid`, `price`, `best_ask`, `item_value`, `total_value`) are returned in **minor units** of the response currency. Divide by 100 to get the display value. For example, `lowest_ask = 2550` with `currency = USD` means **\$25.50**.
`/prices` and `/bids` also return a string companion to the integer price — `lowest_ask_decimal` and `highest_bid_decimal`. These carry adaptive precision: two decimal places at or above `1.0`, eight below it. Use them for low-value currencies (notably crypto such as `BTC`) where the integer minor-units field rounds to `0`. For example, a \$25.50 skin priced in BTC returns `lowest_ask = 0` but `lowest_ask_decimal = "0.00041600"`.
## Field availability
Fields marked **Yes** are included in that endpoint's response. Fields marked **–** are not.
| Field | /prices | /bids | /sales |
| --------------------- | :--------: | :---: | :----: |
| `item_id` | ✅ | ✅ | ✅ |
| `market_hash_name` | ✅ | ✅ | ✅ |
| `phase` | ✅ | ✅ | ✅ |
| `provider` | ✅ | ✅ | ✅ |
| `timestamp` | ✅ | ✅ | ❌ |
| `last_updated` | ✅ | ✅ | ❌ |
| `date` | ❌ | ❌ | ✅ |
| `lowest_ask` | ✅ | ❌ | ❌ |
| `lowest_ask_decimal` | ✅ | ❌ | ❌ |
| `highest_bid` | ❌ | ✅ | ❌ |
| `highest_bid_decimal` | ❌ | ✅ | ❌ |
| `price` | ❌ | ❌ | ✅ |
| `quantity` | ✅ | ❌ | ❌ |
| `num_bids` | ❌ | ✅ | ❌ |
| `link` | ✅ | ❌ | ❌ |
| `url` | Yes (paid) | ❌ | ❌ |
## Portfolio and transaction fields
These fields are specific to the portfolio system and appear on [`/portfolio/items`](/api-reference/portfolio#portfolio-management) and [`/portfolio/transactions`](/api-reference/portfolio#transactions).
| Field | Type | Description |
| ---------------- | ------- | ----------------------------------------------------------------------------------- |
| `portfolio_id` | uuid | Unique ID for the portfolio. |
| `source` | string | Where the portfolio entry came from. One of: `manual`, `steam`, `csv`. |
| `steam_assetid` | string | Original Steam asset ID for items imported from a Steam inventory. |
| `type` | string | Transaction type: `buy` or `sell`. |
| `marketplace` | string | Provider or marketplace key where the transaction happened, for example `skinport`. |
| `price` | integer | Transaction unit price in minor units. |
| `fee_amount` | integer | Total fee paid for the transaction, in minor units. |
| `fee_percentage` | float | Fee percentage in decimal form, for example `0.05` for 5%. |
| `date` | date | ISO 8601 date in `YYYY-MM-DD` format. |
| `note` | string | Optional note added by the user. |
## Item identity
These fields identify an item and appear in most responses across the API.
| Field | Type | Description |
| ------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `item_id` | integer | Stable catalog ID assigned by CS2Cap. Prefer this over `market_hash_name` once you have resolved it. |
| `market_hash_name` | string | Canonical Steam market hash name. Use this when you do not have an `item_id` yet. |
| `phase` | string | Doppler or Gamma Doppler variant label, for example `Phase 1` or `Emerald`. Returns `null` when phase is not relevant to the item. |
| `provider` | string | Provider key used by this API, for example `steam`, `buff163`, or `csfloat`. Use provider keys in request parameters, not brand names. |
## Price fields
All price fields are returned in minor units of the response currency. See the note at the top of this page.
| Field | Type | Endpoint | Description |
| --------------------- | ------- | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `lowest_ask` | integer | [`/prices`](/api-reference/prices) | Current best ask price across listed offers. |
| `lowest_ask_decimal` | string | [`/prices`](/api-reference/prices) | `lowest_ask` as an adaptive-precision decimal string (eight places below `1.0`). Use for sub-cent currencies such as crypto. |
| `highest_bid` | integer | [`/bids`](/api-reference/bids) | Current best buy order price. |
| `highest_bid_decimal` | string | [`/bids`](/api-reference/bids) | `highest_bid` as an adaptive-precision decimal string (eight places below `1.0`). Use for sub-cent currencies such as crypto. |
| `price` | integer | [`/sales`](/api-reference/sales) | Completed sale price. |
| `best_ask` | integer | [`/portfolio/value`](/api-reference/portfolio#valuation) | Lowest ask across all queried providers for the item. |
| `item_value` | integer | [`/portfolio/value`](/api-reference/portfolio#valuation) | `best_ask × quantity`. |
| `total_value` | integer | [`/portfolio/value`](/api-reference/portfolio#valuation) | Sum of all `item_value` amounts in the response. |
## Sale fields
| Field | Type | Description |
| ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `quantity` | integer | Number of units in the listing. Returned by [`/prices`](/api-reference/prices). |
| `num_bids` | integer | Number of active buy orders at the reported `highest_bid` price level. Returned by [`/bids`](/api-reference/bids). |
| `date` | datetime | ISO 8601 UTC timestamp for when the sale happened on the provider marketplace. Returned by [`/sales`](/api-reference/sales). |
| `currency` | string | ISO 4217 currency code used by the values in the record, for example `USD`. |
## Timestamp fields
| Field | Type | Description |
| -------------- | -------- | ---------------------------------------------------------------------------------------------------- |
| `timestamp` | datetime | When the price or bid last actually changed. |
| `last_updated` | datetime | When this record was last refreshed, even if the value didn't change. |
| `date` | datetime | Time when the sale event was reported by the provider. Returned by [`/sales`](/api-reference/sales). |
## Link fields
| Field | Type | Tier | Description |
| ------ | ------ | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `link` | string | All tiers | Tracked redirect URL through the CS2Cap domain (`/r/:provider/:item_id`). It resolves to the marketplace listing and may include affiliate or referral tracking. |
| `url` | string | `pro`, `quant` | Direct marketplace URL with no API-domain redirect. |
## Pagination
List endpoints return a `pagination` object alongside `items`.
| Field | Type | Description |
| ------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit` | integer | Number of items returned per page. |
| `offset` | integer | Zero-based starting position for offset-based endpoints. |
| `total` | integer | Total number of matching items. Always `-1` on cursor-based endpoints — use `has_next` and `next_cursor` to paginate instead. |
| `has_next` | boolean | Whether more items exist after the current page. |
| `has_prev` | boolean | Whether items exist before the current page. |
| `next_cursor` | string | Cursor string for cursor-based endpoints. Pass it back as the `cursor` parameter to get the next page. `null` means there are no more pages. |
On cursor-based endpoints, `pagination.total` is always `-1`. Use `has_next` and `next_cursor` to paginate.
## Response envelope
Most list endpoints return these top-level fields:
| Field | Type | Description |
| ------------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------- |
| `items` | array | Main data payload. |
| `pagination` | object | Pagination metadata. See [Pagination](#pagination) above. |
| `meta` | object | Response context such as currency, filters, and returned providers. |
| `meta.currency` | string | ISO 4217 currency code that all price values in the response use. |
| `meta.returned_providers` | array\[string] | Provider keys that returned data in this response. This can be a subset of what you requested. |
| `meta.filters` | object | Echo of the effective filters applied to the request, including `market_hash_name`, `phase`, and `providers_queried`. |
## Item catalog fields
These fields are returned by [`/items`](/api-reference/catalog#get-/items-—-list-items).
| Field | Type | Description |
| ------------------ | -------------- | ------------------------------------------------------------------- |
| `item_type` | string | Top-level item class, for example `weapon`, `gloves`, or `sticker`. |
| `item_subtype` | string | More specific classification within `item_type`. |
| `weapon_type` | string | Weapon-specific classification when applicable. |
| `base_name` | string | Base item name without finish or wear details. |
| `skin_name` | string | Finish or paint name. |
| `wear_name` | string | Exterior bucket, for example `Factory New` or `Field-Tested`. |
| `rarity_name` | string | Human-readable rarity tier, for example `Classified` or `Covert`. |
| `rarity_color` | string | Normalized hex alias for the rarity color. |
| `collection` | string | Collection name, when available. |
| `collection_image` | string | Collection image URL, when available. |
| `crates` | array\[string] | Cases or crates the item can come from. |
| `crates_images` | array\[string] | Crate image URLs aligned by index with `crates`. |
| `release_date` | string | Item release date as `YYYY-MM-DD`, when available. |
| `is_stattrak` | boolean | Whether the item is a StatTrak variant. |
| `is_souvenir` | boolean | Whether the item is a Souvenir variant. |
| `min_float` | float | Lowest possible float value for the item variant. |
| `max_float` | float | Highest possible float value for the item variant. |
| `def_index` | string | CS2 definition index for the base item type. |
| `paint_index` | integer | CS2 paint index for the skin variant. |
| `image_url` | string | Item artwork served through the CS2Cap CDN. |
| `supply` | integer | Approximate circulating supply, when available. |