Skip to main content
POST
/
wallet
/
accounts
/
{account_id}
/
funding
Fund an investment account (deposit)
curl --request POST \
  --url https://api.bluum.finance/v1/wallet/accounts/{account_id}/funding \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": "5000.00",
  "funding_details": {
    "funding_type": "fiat",
    "fiat_currency": "USD",
    "bank_account_id": "bank_id_abc987",
    "method": "ach"
  },
  "description": "Initial account funding",
  "external_reference_id": "ref_12345"
}
'
{
  "transaction_id": "txn_a1b2c3d4e5f6g7h8",
  "account_id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
  "type": "deposit",
  "status": "pending",
  "amount": "5000.00",
  "currency": "USD",
  "funding_type": "fiat",
  "funding_details": {},
  "description": "Initial account funding",
  "external_reference_id": "ref_12345",
  "fee": "0.00",
  "net_amount": "5000.00",
  "created_at": "2025-10-18T10:30:00Z",
  "settled_at": null,
  "failed_at": null,
  "failure_reason": null
}

Authorizations

​
Authorization
string
header
required

HTTP Basic Authentication using the API Key as username and API Secret as password.

Path Parameters

​
account_id
string<uuid>
required
Example:

"3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b"

Body

application/json
​
amount
string
required

Amount to fund the account.

Example:

"5000.00"

​
funding_details
object
required
  • Option 1
  • Option 2
​
description
string

Optional description for the funding transaction.

Example:

"Initial account funding"

​
external_reference_id
string

Optional external reference ID for client tracking.

Example:

"ref_12345"

Response

Deposit request accepted and is pending processing

​
transaction_id
string<uuid>

Unique identifier for the transaction.

Example:

"txn_a1b2c3d4e5f6g7h8"

​
account_id
string<uuid>

Account ID associated with the transaction.

Example:

"3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b"

​
type
enum<string>

Type of transaction.

Available options:
deposit,
withdrawal
Example:

"deposit"

​
status
enum<string>

Current status of the transaction.

Available options:
pending,
processing,
settled,
failed,
canceled
Example:

"pending"

​
amount
string

Transaction amount.

Example:

"5000.00"

​
currency
string

Currency of the transaction.

Example:

"USD"

​
funding_type
enum<string>

Type of funding used.

Available options:
fiat,
crypto
Example:

"fiat"

​
funding_details
object

Details of the funding method used.

​
description
string

Description of the transaction.

Example:

"Initial account funding"

​
external_reference_id
string

External reference ID for client tracking.

Example:

"ref_12345"

​
fee
string

Fee charged for the transaction.

Example:

"0.00"

​
net_amount
string

Net amount after fees.

Example:

"5000.00"

​
created_at
string<date-time>

Timestamp when the transaction was created.

Example:

"2025-10-18T10:30:00Z"

​
settled_at
string<date-time> | null

Timestamp when the transaction was settled.

Example:

null

​
failed_at
string<date-time> | null

Timestamp when the transaction failed.

Example:

null

​
failure_reason
string | null

Reason for transaction failure if applicable.

Example:

null