Treasury Rail

Position and liquidity management endpoints.

Overview

The Treasury rail provides:

Position management
Liquidity monitoring
Cash flow forecasting
FX operations (Shariah-compliant)

Endpoints

Get Positions

GET /v1/treasury/positions

const positions = await iof.treasury.getPositions({
  currency: "USD",
  asOf: "2024-01-15",
});

Response:

{
  "positions": [
    {
      "currency": "USD",
      "balance": 1500000,
      "available": 1200000,
      "reserved": 300000,
      "asOf": "2024-01-15T00:00:00Z"
    }
  ]
}

Get Liquidity

GET /v1/treasury/liquidity

const liquidity = await iof.treasury.getLiquidity({
  horizon: "7d",
});

Create Transfer

POST /v1/treasury/transfers

const transfer = await iof.treasury.createTransfer({
  from: { account: "acc_123" },
  to: { account: "acc_456" },
  amount: 100000,
  currency: "USD",
});

Forecast Cash Flow

POST /v1/treasury/forecast

const forecast = await iof.treasury.forecast({
  startDate: "2024-01-15",
  endDate: "2024-01-31",
  granularity: "daily",
});

Response:

{
  "forecast": [
    {
      "date": "2024-01-15",
      "inflows": 50000,
      "outflows": 30000,
      "netFlow": 20000,
      "projectedBalance": 1520000
    }
  ]
}

FX Quote

POST /v1/treasury/fx/quote

const quote = await iof.treasury.getFXQuote({
  sellCurrency: "USD",
  buyCurrency: "MYR",
  amount: 100000,
  side: "sell",
});

Position Types

Type	Description
`nostro`	Nostro account balances
`vostro`	Vostro account balances
`internal`	Internal positions

Webhooks

Event	Description
`treasury.position.updated`	Position changed
`treasury.threshold.breached`	Limit breached
`treasury.transfer.completed`	Transfer completed

Next Steps

Clearing Rail - Settlement operations
Ledger Rail - Accounting entries