Transfers

The Partner API exposes endpoints for exchange to/from blockchain: moving shares between the blockchain (e.g. FGRS) and brokerage (e.g. FIGR). In the UI this is “Exchange to brokerage” and “Exchange to blockchain.” The API uses the Transfers tag and calls these operations NMS send and NMS receive. Full request/response details are in the Partner API OpenAPI spec — Transfers.

Note: The API puts “transfer history” (the list of past deposits, withdrawals, sends, etc. for your account) under Accounts, not under this Transfers tag. See Accounts — Transfer history. This page is only for exchange to/from blockchain (NMS send/receive).

---

Exchange to brokerage

Exchange blockchain shares (e.g. FGRS) for brokerage-eligible shares (e.g. FIGR). In the API this is NMS send — you send shares to an external brokerage.

Initiate sending NMS shares: POST /api/v1/transfers/nms/send

Example body:

{
  "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
  "amount": 100,
  "asset": "FGRS",
  "brokerage": {
    "brokerageName": "National Financial Services LLC",
    "dtcNumber": "0226",
    "accountNumber": "X012345678"
  }
}

Required: uuid (unique id for the send), amount, asset, brokerage (brokerage name, DTC number, account number). The amount field is in whole-share equivalent (as used in brokerage terms). The request body is where the user specifies their receiving brokerage’s DTC info — i.e. where we should send the shares.

After the request is submitted, the user must tell their receiving brokerage to look for the shares coming from the following (source of the free-of-payment transfer). These instructions are the same for all Exchange to brokerage transfers:

Detail	Value
DTC brokerage name	UMB Bank, n.a.
DTC participant number	2450
DTC agent ID / institution ID	28825
For further credit to	168646.1 Figure Technology Solutions Inc
Amount	Quantity and asset for the transfer (e.g. 5,413 FIGR).

Transfer status can be tracked in the app under Activity → Transfers (or via the API where supported).

---

Exchange to blockchain

Exchange brokerage-eligible shares (e.g. FIGR) for blockchain shares (e.g. FGRS). In the API this is NMS receive — you create a request to receive shares from an external brokerage. You send FIGR from the brokerage; the request may use asset: "FGRS" (the asset you are receiving) depending on the API.

Before sending the API request, the user must contact their brokerage and instruct them to transfer their shares free-of-payment to the following account (where we receive). These instructions are the same for all Exchange to blockchain transfers:

Detail	Value
DTC brokerage name	UMB Bank, n.a.
DTC participant number	2450
DTC agent ID / institution ID	28825
For further credit to	168646.1 Figure Technology Solutions Inc
Amount	Number of FIGR shares to transfer.

The user must also have their brokerage’s DTC participant number and account number — the API request body includes this so we can match the incoming transfer to the correct account.

Create a request to receive NMS shares: POST /api/v1/transfers/nms/receive

Example body:

{
  "uuid": "a2c4e6g8-i0k2-m4n6-p8q0-s2u4w6y8z0a2",
  "asset": "FGRS",
  "quantity": 100,
  "brokerage": {
    "brokerageName": "National Financial Services LLC",
    "dtcNumber": "0226",
    "accountNumber": "X012345678"
  }
}

Required: uuid (unique id for the receive), asset (e.g. FGRS — the blockchain asset you are receiving), quantity, brokerage (brokerage name, DTC number, account number). The quantity field is in whole-share equivalent (as used in brokerage terms). See the Transfers spec for request/response schemas and parameters.