API reference
4 operations in fx. Raw spec: openapi.json.
GET
/api/v1/fx/ratesGET /api/fx/rates — the org's append-only rate book, newest first.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
base_currency | query | string | No | |
quote_currency | query | string | No |
Responses
| Status | Description |
|---|---|
200 |
Security: bearer
POST
/api/v1/fx/ratesPOST /api/fx/rates — manual entry (the built-in provider's write path). Append-only: corrections are new rows; the effective-rate resolver always picks the newest capture on-or-before the requested date.
Request body
RecordRateRequest
Responses
| Status | Description |
|---|---|
200 | |
422 |
Security: bearer
GET
/api/v1/fx/rates/resolveGET /api/fx/rates/resolve — the effective rate for one direction on one date (defaults to today). Read-only; mirrors the resolver the lock-moment write paths use.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
from | query | string | Yes | |
to | query | string | Yes | |
as_of | query | string | No |
Responses
| Status | Description |
|---|---|
200 | |
404 |
Security: bearer
GET
/api/v1/fx/reconciliationGET /api/fx/reconciliation — the FX deliverable to the books (FX7): original amount, rate, source/date, base equivalent, sync target. The core records conversions that happened; realized/unrealized gain-loss stays in the accounting system.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
limit | query | integer | No |
Responses
| Status | Description |
|---|---|
200 |
Security: bearer