Bid.price

The bid price as a CPM, the price per thousand impressions, even though the bid buys a single impression. Required, and expressed in the currency named by BidResponse.cur.

CurrentfloatRequiredSince 2.0

Field facts

Path: seatbid.bid.price
Object: Bid
Type: float
Requirement: Required
Added: OpenRTB 2.0
Spec section: 4.2.3

How it is used

Bids below the floor, Imp.bidfloor or Deal.bidfloor for a deal, are dropped. Handle money as fixed-point or decimal values in code, because floating-point arithmetic accumulates rounding errors across millions of bids. In a first price auction the price is what you pay, less any seller discount; in a second price plus auction it is your ceiling.

Example

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

{
  "seatbid": [
    {
      "bid": [
        {
          "price": 2.15
        }
      ]
    }
  ]
}

Common mistakes

Sending a per-impression price, such as 0.0025 for a $2.50 CPM.
Sending the price as a string such as "2.50".
Pricing in EUR without setting BidResponse.cur, so the exchange reads the number 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	float	Yes	No
2.3 to 2.6-202606	float	Yes	No

Related fields

Other Bid fields

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