Fund wallet

curl -X POST "{{base_url}}/account/fund" \
  -H "x-api-key: YOUR_CONSUMER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency_code":"KES"}'

{
  "code": 200,
  "message": "Fund wallet details",
  "data": {
    "currency_code": "KES",
    "selling_rate": 131.2,
    "networks": [
      {
        "network": "BASE",
        "settlement_wallet_address": "0x...",
        "assets": ["USDC"]
      },
      {
        "network": "CELO",
        "settlement_wallet_address": "0x...",
        "assets": ["USDT", "USDC"]
      }
    ]
  }
}

POST

account

fund

curl -X POST "{{base_url}}/account/fund" \
  -H "x-api-key: YOUR_CONSUMER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency_code":"KES"}'

{
  "code": 200,
  "message": "Fund wallet details",
  "data": {
    "currency_code": "KES",
    "selling_rate": 131.2,
    "networks": [
      {
        "network": "BASE",
        "settlement_wallet_address": "0x...",
        "assets": ["USDC"]
      },
      {
        "network": "CELO",
        "settlement_wallet_address": "0x...",
        "assets": ["USDT", "USDC"]
      }
    ]
  }
}

First step of wallet funding. Returns the current FX rate and Pretium settlement addresses per network. Send stablecoin to one of those addresses, then call Fund confirm.

string

required

Fiat wallet currency such as KES or UGX (case-insensitive).

string

Currency code of the wallet being funded.

number

Current FX rate for the market. Confirm credits use the rate at confirmation time.

array

Settlement options. Each item has network, settlement_wallet_address, and assets.

Supported networks & assets

Network	Assets
`BASE`	`USDC`
`ETHEREUM`	`USDT`, `USDC`
`SOLANA`	`USDT`, `USDC`
`CELO`	`USDT`, `USDC`

Errors

Status	Message	When
`400`	Validation message	Missing `currency_code`
`400`	`Country not supported.`	Unknown currency
`404`	`Wallet not found!`	No partner wallet for that currency

curl -X POST "{{base_url}}/account/fund" \
  -H "x-api-key: YOUR_CONSUMER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency_code":"KES"}'

{
  "code": 200,
  "message": "Fund wallet details",
  "data": {
    "currency_code": "KES",
    "selling_rate": 131.2,
    "networks": [
      {
        "network": "BASE",
        "settlement_wallet_address": "0x...",
        "assets": ["USDC"]
      },
      {
        "network": "CELO",
        "settlement_wallet_address": "0x...",
        "assets": ["USDT", "USDC"]
      }
    ]
  }
}

⌘I

Overview

Account

Rates

Payments (v1)

Banks

Checkout

Collection & disbursement

Supported networks & assets

Errors

​Supported networks & assets

​Errors

Supported networks & assets

Errors