Imp.bidfloorcur

Currency of Imp.bidfloor as an ISO-4217 alphabetic code such as USD or EUR. Defaults to USD. It may differ from the currency of the bids if the exchange allows that.

CurrentstringOptionalSince 2.0

Field facts

Path
imp.bidfloorcur
Object
Imp
Type
string
Default
USD
Requirement
Optional
Added
OpenRTB 2.0
Spec section
3.2.4

How it is used

The current 2.6 text says this currency also applies to every other floor inside the Imp, such as duration floors and per-second pod floors. It does not reach deals: Deal.bidfloorcur has its own USD default. When the floor currency differs from the bid currency in BidRequest.cur, the bidder converts the floor before comparing prices.

Example

Where the field sits in a payload, with everything else left out:

{
  "id": "req-1",
  "imp": [
    {
      "bidfloorcur": "USD"
    }
  ]
}

Common mistakes

  • Lowercase or invented codes such as "usd" or "yen". The validator reports openrtb.imp.bidfloorcur_format_invalid.
  • Setting a non-USD currency on the Imp and assuming deal floors follow it. They do not, so a deal floor without its own currency reads as USD.

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.

VersionsType in the specRequiredDeprecated
2.0 to 2.1stringNoNo
2.2stringNoNo
2.3 to 2.4string, default “USD”NoNo
2.5string, default “USD”NoNo
2.6-202210 to 2.6-202606string, default USDNoNo

Related fields

Other Imp fields

For a walkthrough of the whole object, read Bid request anatomy.