First Leeward

Virtual Assets

Set rate for virtual asset

PUThttps://api.firstleeward.com/v0/virtual-assets/:id/rate

Sets a new exchange rate (in the project billing currency) for a virtual asset with FIXED rate source. Not available for HTTP rate source assets.

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

idstring<uuid>required

Virtual asset ID

Body

application/json

ratenumberrequired

New rate for 1 unit of this virtual asset, in the project billing currency. Only available for virtual assets with FIXED rate source. Takes effect immediately: every balance valuation, authorization, and SETTLEMENT posting after this call uses it. Postings already made keep the rate they were priced at.

Response

200Virtual asset definition
idstring<uuid>required

Unique virtual asset identifier

symbolstringrequired

Virtual asset symbol

namestringrequired

Display name

decimalsintegerrequired

Number of decimal places for amounts

statusstringrequired

Lifecycle status. Disabled assets are excluded from balance computation.

Available options:ACTIVEDISABLED
rateSourcestringrequired

How the exchange rate (in the project billing currency) is determined for this virtual asset.

Available options:FIXEDHTTP
httpEndpointstring | nullrequired

Rate endpoint URL. Present only for HTTP rate source.

currentRatenumber | nullrequired

Latest known rate per unit, in the project billing currency. This is the rate a SETTLEMENT posting made now would be priced at. Null if no rate snapshot exists yet.

currentRateUpdatedAtstring | nullrequired

ISO 8601 timestamp of the latest rate snapshot. Null when currentRate is null.

allocatedobjectrequired

Total amount of this virtual asset allocated across all accounts in the project.

Show child attributes
amountstringrequired

Total allocated across all users in this project, in the virtual asset's native units. Decimal string padded to the asset's decimals.

valuenumber | nullrequired

Value of amount at the current rate, in the project billing currency. Null when no rate is available (e.g. disabled assets with no recent snapshot).

createdAtstringrequired

ISO 8601 creation timestamp

updatedAtstringrequired

ISO 8601 last update timestamp

400Operation not supported for this rate source
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired
404Virtual asset not found
errorobjectrequired
Show child attributes
codestringrequired
messagestringrequired
detailobject | nullrequired