Skip to main content
POST
Create an inventory lot from an INVENTORY quote

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string
required

Unique key to prevent duplicate creation or execution.

Required string length: 8 - 128

Body

application/json
quoteId
string
required

Cotação usage = INVENTORY, AVAILABLE e não expirada. Define taxa, volume e validade do lote.

externalId
string

ID da MSB para o lote. Opcional; se informado, único por cliente entre Inventories.

Maximum string length: 128
metadata
object

Response

Inventory Lot criado

Inventory Lot: câmbio contratado antecipadamente pela MSB e promessa de pagamento em USDC. Cada aceite de cotação INVENTORY cria um lote independente, com taxa, volume e validade próprios. total = available + reserved + used. A obrigação em USDC existe independentemente de withdrawals e se refere ao volume não utilizado; o evento e a data de apuração e cobrança serão comunicados antes da disponibilidade geral.

inventoryId
string
required
Example:

"inv_01JA2B"

quoteId
string
required

Cotação INVENTORY que originou o lote.

status
enum<string>
required

ACTIVE: dentro da validade, com volume disponível. DEPLETED: sem volume disponível (todo reservado ou utilizado); volta a ACTIVE se uma reserva for liberada dentro da validade. EXPIRED: passou de expiresAt; não aceita novos withdrawals. O tratamento do volume remanescente após a expiração será comunicado antes da disponibilidade geral. Enum extensível.

Available options:
ACTIVE,
DEPLETED,
EXPIRED
fromCurrency
enum<string>
required
Available options:
USD
toCurrency
enum<string>
required
Available options:
BRL
rate
string
required

Taxa contratada entre a MSB e a LB Pay (BRL por USD), já com o spread. Aplicada a todas as remessas do lote.

Pattern: ^[0-9]+(\.[0-9]{1,8})?$
Example:

"5.40000000"

total
object
required

Volume contratado.

available
object
required

Volume disponível para novos withdrawals.

reserved
object
required

Volume reservado por withdrawals em andamento.

used
object
required

Volume já utilizado por withdrawals.

expiresAt
string<date-time>
required

Validade do lote.

createdAt
string<date-time>
required
updatedAt
string<date-time>
required
externalId
string | null
referenceRate
string

BRL por USD, até 8 casas decimais.

Pattern: ^[0-9]+(\.[0-9]{1,8})?$
Example:

"5.43210000"

spread
object

Spread de câmbio: única tarifa da remessa.

pendingSettlement
object | null

Obrigação em USDC referente ao volume não utilizado. null até a apuração, cujo evento será comunicado antes da disponibilidade geral.

settlementId
string | null

Lote de liquidação da obrigação, quando existir.

metadata
object