BidResponse.cur
The currency of every bid price in this response, as an ISO 4217 code. When omitted, USD is assumed.
Field facts
- Path
cur- Object
- BidResponse
- Type
- string
- Default
USD- Requirement
- Optional
- Added
- OpenRTB 2.0
- Spec section
- 4.2.1
How it is used
The currency must be one the request allowed in BidRequest.cur; if the request listed none, USD is the shared assumption. A response has one currency, so a bidder that prices internally in several currencies converts before it responds.
Example
Where the field sits in a payload, with everything else left out:
{
"cur": "USD"
}Common mistakes
- Bidding in a currency the request did not allow (
openrtb.response.cur_not_allowed). - Lowercase codes or symbols such as usd or $. Use three uppercase letters.
- Omitting
curwhile pricing in EUR, so the exchange reads every price as US dollars.
Version history
Added in OpenRTB 2.0, and present in the latest snapshot. The table shows how each version's spec text types the field.
| Versions | Type in the spec | Required | Deprecated |
|---|---|---|---|
| 2.0 to 2.2 | string | No | No |
| 2.3 to 2.5 | string, default “USD” | No | No |
| 2.6-202210 to 2.6-202606 | string, default USD | No | No |
Related fields
Other BidResponse fields
For a walkthrough of the whole object, read Bid response anatomy.