Retrive virtual account

Virtual account number can be retrieved as the deposit instructions for a specific portfolio. Returns bank account details for fiat rails (US Fedwire, SWIFT). This API can also be used to retrive wallet addresses for supported stablecoins/networks.

HTTP Request

GET
https://sandbox-api.1money.com/v1/portfolios/{portfolio_id}/instruction

Path Parameters

Parameter	Type	Description
`portfolio_id`	string	UUID of the portfolio to retrieve instructions for

Query Parameters

Parameter	Type	Description
`asset`	string	Fiat currency filter, e.g. `USD` , or crypto asset symbol, e.g. `USDC`, `USDT`
`network`	string	Bank rail filter, e.g. `US_FEDWIRE`, `SWIFT`, or blockchain network, e.g. `ETHEREUM`, `SOLANA`, `BASE`, `ARBITRUM`

Headers

Header	Description
`X-Api-Key`	Your API key (required)
`Content-Type`	`application/json`

Response Examples

Example: Fiat – US Fedwire

{
  "asset": "USD",
  "network": "US_FEDWIRE",
  "bank_instruction": {
    "bank_name": "Sample Bank Name",
    "routing_number": "121140399",
    "account_holder": "1Money",
    "account_number": "123-456789-0",
    "memorandum": "AC:0D123C4EE0F5",
    "account_identifier": "0d123c4ee0f5",
    "bic_code": "SSBAUS32",
    "address": {
      "full_address": "490 2nd St Suite 300, San Francisco, CA 94107",
      "country_code": "USA",
      "address_line1": "490 2nd St",
      "address_line2": "Suite 300",
      "city": "San Francisco",
      "region": "CA",
      "postal_code": "94107"
    },
    "transaction_fee": "0.0005"
  },

  "transaction_action": "DEPOSIT",
  "created_at": "2025-08-21T07:56:57.981Z",
  "modified_at": "2025-08-21T07:56:57.981Z"
}

Example: Stablecoin – USDC

{
  "asset": "USDC",
  "network": "ARBITRUM",
   "wallet_instruction": {
    "wallet_address": "0xa0C0f8248487B8f5bF2e9715d966CF29A704a494",
    "transaction_fee": "0.0005"
  },
  "transaction_action": "DEPOSIT",
  "created_at": "2025-08-21T07:56:57.981Z",
  "modified_at": "2025-08-21T07:56:57.981Z"
}