Create a new cost
Authorizations
Request Body required
object
A representation of a piecewise-linear, weakly monotone decreasing demand curve
Demand curves define a bidder’s willingness to pay for different quantities of a good. In flow trading, these curves must be:
- Piecewise-linear (defined by a sequence of points)
- Weakly monotone decreasing (price non-increasing as rate increases)
- Include the point rate=0 in their domain (must allow zero trade)
A representation of a point for use in defining piecewise-linear curves
Each point consists of:
- A rate (quantity per time unit)
- A price (value per unit)
Points are used to define the vertices of piecewise-linear demand curves.
object
The price (value per unit) coordinate
The rate (quantity per time) coordinate
A representation of a flat demand curve supporting interval, half-line, and full-line trading domains
A constant curve represents a fixed price for trades within a specified rate range. This can be used to express indifference to (potentially unbounded) trade rates at a specific price.
The sign convention follows flow trading standards:
- min_rate ≤ 0 (non-positive): maximum selling rate
- max_rate ≥ 0 (non-negative): maximum buying rate
object
The fastest rate at which the portfolio may buy (non-negative)
The fastest rate at which the portfolio may sell (non-positive)
The fixed price at which trades within the rate range are valued
object
Responses
201
A full description of a cost
A CostRecord combines all the information needed to define a cost:
- Who owns it (bidder_id)
- Which auths it applies to (group)
- The utility function (data)
object
The responsible bidder’s id
A unique id for the cost
A representation of a piecewise-linear, weakly monotone decreasing demand curve
Demand curves define a bidder’s willingness to pay for different quantities of a good. In flow trading, these curves must be:
- Piecewise-linear (defined by a sequence of points)
- Weakly monotone decreasing (price non-increasing as rate increases)
- Include the point rate=0 in their domain (must allow zero trade)
A representation of a point for use in defining piecewise-linear curves
Each point consists of:
- A rate (quantity per time unit)
- A price (value per unit)
Points are used to define the vertices of piecewise-linear demand curves.
object
The price (value per unit) coordinate
The rate (quantity per time) coordinate
A representation of a flat demand curve supporting interval, half-line, and full-line trading domains
A constant curve represents a fixed price for trades within a specified rate range. This can be used to express indifference to (potentially unbounded) trade rates at a specific price.
The sign convention follows flow trading standards:
- min_rate ≤ 0 (non-positive): maximum selling rate
- max_rate ≥ 0 (non-negative): maximum buying rate
object
The fastest rate at which the portfolio may buy (non-negative)
The fastest rate at which the portfolio may sell (non-positive)
The fixed price at which trades within the rate range are valued
The group associated to the cost. Because it is not always required, some endpoints may omit its definition.
The “last-modified-or-created” time as recorded by the system