Add a pricing rule

Appends a new pricing rule to the contract's active program, creating a new approved pricing program version (append-only; prior versions are preserved). Use this to set up counterparty-scoped rules — e.g. waiving the maker fee for a specific counterparty — before submitting usage.

Authorization

AuthorizationBearer <token>

API key as Bearer token: Authorization: Bearer luc_live_...

In: header

Path Parameters

ext_id*string

The external ID of the contract.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

id?string

name?string

type?string

model?string

amount?string

Flat amount (for flat model).

rate?number

Rate multiplier (for percentage model).

metric?string

Metric name (for usage rules).

frequency?string

Billing frequency (for subscription rules).

monthly_cap?string

Monthly cap amount (for percentage model).

currency?string

counterparty?|array<string>

Restricts a usage rule to events from these counterparties (matched against the event's counterparty). Omit for a default rule that applies to all counterparties.

counterparty_side?string

Restricts a counterparty-scoped rule to events on this side of the trade. An explicit maker/taker rule takes precedence over a side-agnostic (any) rule.

Response Body

`application/json`

curl -X POST "https://example.com/v1/billing/contracts/acme-corp-2026/pricing-rules" \  -H "Content-Type: application/json" \  -d '{    "name": "Maker fee waiver — counterparty acme-markets",    "type": "usage",    "model": "percentage",    "rate": 0,    "metric": "trading_volume",    "counterparty": "acme-markets",    "counterparty_side": "maker"  }'

{  "object": "pricing_rule",  "contract": "string",  "version": 0,  "rule": {    "id": "string",    "name": "string",    "type": "subscription",    "model": "flat",    "amount": "string",    "rate": 0,    "metric": "string",    "frequency": "monthly",    "monthly_cap": "string",    "currency": "string",    "counterparty": "string",    "counterparty_side": "maker"  }}

{  "error": "Missing API key"}

{  "error": "Not found"}

{  "error": "string"}

Add a pricing rule

Authorization

Path Parameters

Request Body

Response Body

201application/json

401application/json

404application/json

409application/json

Example missing

Example invalid

Example expired

`application/json`

`application/json`

`application/json`

`application/json`