Create a rate card
Create a rate card mapping meter unit types to a contracted price per unit (integer minor currency units), targeted by substrate / counterparty / scope and pinned to a currency. Cards are created DRAFT by default; activation is a separate, explicit step (a card moves real money exactly like a settlement rule does) — pass activateOnCreate: true to go straight to ACTIVE, or SCHEDULED when activeFrom is in the future. One price per unit type per card. Requires scope settlement:write.
Authorizations
API key sent as Authorization: Bearer <api-key>.
Body
Operator-facing label (required, non-empty).
Priced unit types; one entry per unit type.
1Optional targeting block. If omitted, a targeting block is synthesised from the top-level substrate, appliesToScope, and currency fields.
Convenience — seeds targeting.substrates when targeting is omitted.
Convenience — seeds targeting.appliesToScope when targeting is omitted.
ISO 4217 currency (upper-cased). Defaults to GBP.
Defaults to now. A future value yields SCHEDULED when activated on create.
Author attribution. Defaults to "developer".
When true, create the card ACTIVE (or SCHEDULED if activeFrom is in the future).