First Leeward

Virtual Asset Postings

Get posting

GEThttps://api.firstleeward.com/v0/postings/:postingId

Client-driven postings (deposit, withdrawal, settlement) against an account's virtual asset balances.

Authorizations

Authorizationstring · headerrequired

API key as Bearer token, e.g. Bearer YOUR_API_KEY

Headers

Leeward-Versionenum<string>required

API version (YYYY-MM-DD). Available option: 2026-09-18

Path Parameters

postingIdstring<uuid>required

Posting ID

Response

200Client-driven posting against an account.
idstring<uuid>required

Posting ID

accountIdstring<uuid>required

Account ID

typestringrequired
  • DEPOSIT: Credit the submitted virtual asset amounts to the account balance.
  • WITHDRAWAL: Debit the submitted virtual asset amounts from the account balance. Rejected if any entry would take the balance below zero.
  • SETTLEMENT: Debit the submitted virtual asset amounts from the account balance AND apply their value to the account’s outstanding card debt. Same non-negative guard as WITHDRAWAL.
Available options:DEPOSITWITHDRAWALSETTLEMENT
entriesobject[]required
Show child attributes
virtualAssetIdstring<uuid>required

Virtual asset ID

amountstringrequired

Entry amount in the virtual asset denomination

rateSnapshotnumber | nullrequired

Billing-currency-per-unit rate applied to this entry, read when the posting was made. The entry contributed amount × rateSnapshot to settledAmount. Populated for SETTLEMENT postings, null otherwise.

settledAmountnumber | nullrequired

Value applied to outstanding card debt, in the billing currency of the card program. Each entry is valued at amount × rateSnapshot and rounded to the billing currency's precision, then the entries are summed. Populated for SETTLEMENT postings, null otherwise.

createdAtstringrequired

ISO 8601 creation timestamp

404Posting not found
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired