Units: MT and MFT
The API keeps spot capacity and future-delivery capacity in distinct fields so a client cannot accidentally treat them as the same state.
MT for spot
1 MT = 1,000,000 tokens. Spot prices are quoted in USD per MT. Spot order quantities use size_tokens and must be whole tokens; for example, 10 MT is 10000000.
MFT for forward capacity
1 MFT = 1,000,000 units of forward quantity. Forward prices are quoted in USD per MFT. Forward order quantities use size_mft, encoded as an exact decimal string with up to six fractional places.
The forward instrument declares a conversion_ratio. That field describes the instrument's unit relationship. It must not be interpreted as evidence that external performance has taken place.
Exact values on the wire
Prices, notional values, rates, and MFT quantities cross the API as JSON strings:
<span><span style="color: var(--shiki-color-text)">{</span></span>
<span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-keyword)">"price"</span><span style="color: var(--shiki-token-punctuation)">:</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string-expression)">"0.76230000000000"</span><span style="color: var(--shiki-token-punctuation)">,</span></span>
<span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-keyword)">"size_mft"</span><span style="color: var(--shiki-token-punctuation)">:</span><span style="color: var(--shiki-color-text)"> </span><span style="color: var(--shiki-token-string-expression)">"2.500000"</span></span>
<span><span style="color: var(--shiki-color-text)">}</span></span>
<span></span>
Do not parse those fields through binary floating point when exact reproduction matters. Spot size_tokens values are JSON integers. An order supplies the size field appropriate for its instrument; it does not supply both.
Display units are not wire types
The terminal may render 10000000 tokens as 10 MT. API clients should
preserve the integer or decimal-string value supplied by the route and perform
display conversion at their boundary.