Skip to main content

SubscribeQuote

A price quote, with amounts as decimal strings. Stateless: quoteMac authenticates the canonical JSON (RFC 8785) of all other members, so any API host can verify a quote it did not issue by recomputing the MAC. No quote is stored; two prepare calls simply give two valid quotes. The MAC key differs per environment, so a devnet quote never verifies on mainnet.

quoteIdstringrequired

At most 12 ASCII bytes, because it becomes the ref of the contract call and data bytes are billed at full gas price. It is q_ followed by the first 10 Crockford base32 characters of an HMAC, keyed with the service's quote key, over corelayer/quote-id/v1 followed by the canonical JSON of every member except quoteId and quoteMac. Any API host can recompute it.

Possible values: Value must match regular expression ^q_[0-9A-Z]{10}$

quoteMacstringrequired

HMAC-SHA256 with the service's quote key over corelayer/quote/v1 followed by the canonical JSON of every other member, quoteId included. Base64url without padding.

Possible values: Value must match regular expression ^[A-Za-z0-9_-]{43}$

tierIdintegerrequired
monthsintegerrequired

Possible values: >= 0 and <= 12

tariffDecimalStringrequired

Non-negative integer as decimal string (pricing document family).

Possible values: Value must match regular expression ^[0-9]+$

tariffVersionintegerrequired
tariffEffectiveMsinteger<int64>required

Unix time in milliseconds.

Possible values: >= 0

priceMicroUsdcDecimalStringrequired

Non-negative integer as decimal string (pricing document family).

Possible values: Value must match regular expression ^[0-9]+$

maxPriceDecimalStringrequired

Non-negative integer as decimal string (pricing document family).

Possible values: Value must match regular expression ^[0-9]+$

pendingTariffstring | nullnullablerequired
issuedAtMsinteger<int64>required

Unix time in milliseconds.

Possible values: >= 0

expiresAtMsinteger<int64>required

Unix time in milliseconds.

Possible values: >= 0

SubscribeQuote
{
"quoteId": "string",
"quoteMac": "string",
"tierId": 0,
"months": 0,
"tariff": "string",
"tariffVersion": 0,
"tariffEffectiveMs": 0,
"priceMicroUsdc": "string",
"maxPrice": "string",
"pendingTariff": "string",
"issuedAtMs": 0,
"expiresAtMs": 0
}