BidRequest.cur
The currencies bids may use, as ISO 4217 codes. The spec recommends it only when the exchange accepts more than one currency; otherwise USD is assumed.
Field facts
- Path
cur- Object
- BidRequest
- Type
- string array
- Requirement
- Optional
- Added
- OpenRTB 2.0
- Spec section
- 3.2.1
How it is used
Bidders choose one listed currency and state it in BidResponse.cur. The floor carries its own currency in Imp.bidfloorcur, so a request can quote a floor in one currency and accept bids in another.
Example
Where the field sits in a payload, with everything else left out:
{
"id": "req-1",
"cur": [
"USD",
"EUR"
]
}Common mistakes
- Lowercase codes or symbols such as usd or € (
openrtb.request.cur_format_invalid). - Sending a single string instead of an array.
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.1 | Array of ing b I o e r | No | No |
| 2.2 | array of ings b I | No | No |
| 2.3 to 2.4 | string array | No | No |
| 2.5 | string array | No | No |
| 2.6-202210 to 2.6-202606 | string array | No | No |
Related fields
Other BidRequest fields
For a walkthrough of the whole object, read Bid request anatomy.