1. Treasury
FOMO API (v20260326)
  • Welcome
    • Onboarding
    • Webhook
    • Version History
  • OAuth2
    • Request an access token
      POST
  • Storage
    • Overview 🗺️
    • File
      • Create a file
      • Retrieve a file
      • Download file content
  • Simulator
    • Overview 🗺️
    • MCP for AI Agents ✨
      • JSON Configuration
    • Incoming Transfer
      • Create an incoming transfer
  • Compliance
    • Clearance
      • Retrieve a clearance
      • List clearances
    • Entity
      • Retrieve an entity
      • List entities
    • Account Declaration
      • Retrieve an account declaration
      • List account declarations
    • Account Declaration Proof
      • Retrieve an account declaration proof
      • List account declaration proofs
    • Intents
      • Entity Creation
        • Create an entity creation intent
        • Confirm an entity creation intent
        • Retrieve an entity creation intent
        • List entity creation intents
      • Account Declaration Creation
        • Create an account declaration creation intent
        • Confirm an account declaration creation intent
        • Retrieve an account declaration creation intent
        • List account declaration creation intents
      • Account Declaration Revocation
        • Create an account declaration revocation intent
        • Confirm an account declaration revocation intent
        • Retrieve an account declaration revocation intent
        • List account declaration revocation intents
      • Account Declaration Proof Creation
        • Create an account declaration proof creation intent
        • Confirm an account declaration proof creation intent
        • Retrieve an account declaration proof creation intent
        • List account declaration proof creation intents
      • Account Declaration Proof Answer
        • Create an account declaration proof answer intent
        • Confirm an account declaration proof answer intent
        • Retrieve an account declaration proof answer intent
        • List account declaration proof answer intents
  • Treasury
    • Overview 🗺️
    • MCP for AI Agents ✨
      • (Option 1) MCP Bundles (Recommended)
      • (Option 2) JSON Configuration (Most Compatible)
    • Account
      • Retrieve an account
      • List accounts
    • Balance
      • Retrieve a balance
      • List balances
    • Transaction
      • Retrieve a transaction
      • List transactions
    • Virtual Account
      • Retrieve a virtual account
      • List virtual accounts
    • Account Holder
      • Retrieve an account holder
      • List account holders
    • Outgoing Transfer
      • Retrieve an outgoing transfer
      • List outgoing transfers
    • Incoming Transfer
      • Retrieve an incoming transfer
      • List incoming transfers
    • Internal Transfer
      • Retrieve an internal transfer
      • List internal transfers
    • Beneficiary
      • Retrieve a beneficiary
      • List beneficiaries
    • Beneficiary Account
      • Retrieve a beneficiary account
      • List beneficiary accounts
    • Quote
      • Retrieve a quote
      • List quotes
    • Trade
      • Retrieve a trade
      • List trades
    • Intents
      • Account Holder Creation
        • Create an account holder creation intent
        • Confirm an account holder creation intent
        • Retrieve an account holder creation intent
        • List account holder creation intents
      • Outgoing Transfer Creation
        • Create an outgoing transfer creation intent
        • Confirm an outgoing transfer creation intent
        • Retrieve an outgoing transfer creation intent
        • List outgoing transfer creation intents
      • Virtual Account Creation
        • Create a virtual account creation intent
        • Set account holder for virtual account creation intent
        • Set account name for virtual account creation intent
        • Set external account for virtual account creation intent
        • Confirm a virtual account creation intent
        • Retrieve a virtual account creation intent
        • List virtual account creation intents
      • Virtual Account Update
        • Create a virtual account update intent
        • Set account name for virtual account update intent
        • Confirm a virtual account update intent
        • Retrieve a virtual account update intent
        • List virtual account update intents
      • Virtual Account Closure
        • Create a virtual account closure intent
        • Confirm a virtual account closure intent
        • Retrieve a virtual account closure intent
        • List virtual account closure intents
      • Beneficiary Creation
        • Create a beneficiary creation intent
        • Confirm a beneficiary creation intent
        • Retrieve a beneficiary creation intent
        • List beneficiary creation intents
      • Beneficiary Account Creation
        • Create a beneficiary account creation intent
        • Confirm a beneficiary account creation intent
        • Retrieve a beneficiary account creation intent
        • List beneficiary account creation intents
      • Quote Creation
        • Create a quote creation intent
        • Confirm a quote creation intent
        • Retrieve a quote creation intent
        • List quote creation intents
      • Trade Creation
        • Create a trade creation intent
        • Confirm a trade creation intent
        • Retrieve a trade creation intent
        • List trade creation intents
      • Trade Cancellation
        • Create a trade cancellation intent
        • Confirm a trade cancellation intent
        • Retrieve a trade cancellation intent
        • List trade cancellation intents
      • Internal Transfer Creation
        • Create an internal transfer creation intent
        • Confirm an internal transfer creation intent
        • Retrieve an internal transfer creation intent
        • List internal transfer creation intents
  • Issuing
    • Cardholder
      • Retrieve a cardholder
      • List cardholders
    • Card Program
      • Retrieve a card program
      • List card programs
    • Card
      • Reveal a card's details
      • Retrieve a card
      • List cards
    • Card Transaction
      • Retrieve a card transaction
      • List card transactions
    • Card Transaction Event
      • Retrieve a card transaction event
      • List card transaction events
    • Intents
      • Cardholder Creation
        • Create a cardholder creation intent
        • Confirm a cardholder creation intent
        • Retrieve a cardholder creation intent
        • List cardholder creation intents
      • Card Creation
        • Create a card creation intent
        • Confirm a card creation intent
        • Retrieve a card creation intent
        • List card creation intents
      • Card Update
        • Create a card update intent
        • Confirm a card update intent
        • Retrieve a card update intent
        • List card update intents
      • Card Closure
        • Create a card closure intent
        • Confirm a card closure intent
        • Retrieve a card closure intent
        • List card closure intents
  • Sumsub (Provider)
    • Applicant
      • Create an access token for an applicant
      • Create a WebSDK link for an applicant
      • Retrieve an applicant
      • List applicants
    • Applicant Action
      • Create an access token for an applicant action
      • Create a WebSDK link for an applicant action
      • Retrieve an applicant action
      • List applicant actions
    • Intents
      • Applicant Action Creation
        • Create an applicant action creation intent
        • Confirm an applicant action creation intent
        • Retrieve an applicant action creation intent
        • List applicant action creation intents
      • Applicant Creation
        • Create an applicant creation intent
        • Confirm an applicant creation intent
        • Retrieve an applicant creation intent
        • List applicant creation intents
      • Applicant Update
        • Create an applicant update intent
        • Confirm an applicant update intent
        • Retrieve an applicant update intent
        • List applicant update intents
  • DCS (Provider)
    • Decard Customer
      • Retrieve a decard customer
      • List decard customers
    • Intents
      • Decard Customer Creation
        • Create a decard customer creation intent
        • Confirm a decard customer creation intent
        • Retrieve a decard customer creation intent
        • List decard customer creation intents
  • 🚧 CMS (Provider)
    • Application
      • Retrieve an application
      • List applications
    • Entity
      • Retrieve an entity
      • List entities
    • Intents
      • Application Creation Intent
        • Create an application creation intent
        • Confirm an application creation intent
        • Retrieve an application creation intent
        • List application creation intents
      • Entity Creation Intent
        • Create an entity creation intent
        • Confirm an entity creation intent
        • Retrieve an entity creation intent
        • List entity creation intents
  1. Treasury

Overview 🗺️

The FOMO Treasury API is how your platform holds money, receives it, converts it between currencies or crypto assets, and pays it out - across bank rails and blockchains. This page gives you the high-level picture; the full API reference covers field-level detail.

The building blocks#

ResourceWhat it is
AccountA container that holds one or more Balances, each in a specific currency or crypto asset (e.g. SGD, USD, USDT). This is your working treasury.
BalanceThe actual funds inside an Account for one asset - available amount, total amount, and overdraft limit if applicable.
Virtual AccountA dedicated sending / receiving account (its own bank details or crypto address) that routes incoming funds from / into one of your Accounts. Used for POBO and COBO flows.
Account HolderThe verified legal owner behind an Account and Virtual Account - established through a KYC/KYB check before funds can move.
BeneficiaryA payee: an individual or business you intend to send money to.
Beneficiary AccountThe actual destination for a payment to a Beneficiary - a bank account, crypto address, or payment proxy (PayNow, FPS ID, etc.). One Beneficiary can have several.
QuoteA locked-in exchange rate for converting one asset to another (fiat↔fiat, fiat↔crypto, crypto↔crypto).
TradeA conversion that's actually been executed against a Quote. The converted asset isn't automatically deposited into a Balance - it sits as trade proceeds until you move it out via an Outgoing Transfer (to an external Beneficiary Account) or an Internal Transfer (into one of your own Balances).
Incoming TransferA record of funds that arrived - typically via a Virtual Account - and landed in one of your Balances.
Outgoing TransferSend money from your account to a Beneficiary Account, optionally over a specific payment rail.

How money typically moves#

Receiving money:
A Virtual Account is issued to you (customer) or your customer (client). Funds sent to it land automatically in the linked Account's Balance, and each one shows up as an Incoming Transfer you can look up or list.
Sending money:
1.
Register the Beneficiary (who you're paying) and their Beneficiary Account (where the money goes).
2.
If the payout currency differs from your Balance's currency, get a Quote and execute a Trade to convert funds first.
3.
Create an Outgoing Transfer, specifying the source Balance (or Trade proceeds), the Beneficiary Account, and the payment rail to use.

The "intent" pattern#

Nothing is created directly. Every action that touches money or account details - opening a Virtual Account, adding a Beneficiary, sending an Outgoing Transfer, executing a Trade - goes through a two-step intent:
1.
Create the intent with the details you want to submit.
2.
Confirm the intent to actually execute it.
Between those two steps, an intent may sit in one of these states:
pending-requirements - waiting on more information (see the intent's requirements and optional_requirements list)
pending-approval - waiting on internal sign-off
pending-result - submitted, waiting on the outcome
completed - finished, successfully or not (check the result field)
This separation exists deliberately: it gives you a checkpoint to validate details - especially payee and payment information - before money actually moves, and it means every change to sensitive account or payment configuration is auditable as a discrete, confirmable step rather than an instant side effect.
Previous
List account declaration proof answer intents
Next
(Option 1) MCP Bundles (Recommended)
Built with