Onramp

curl -X POST "{{base_url}}/v1/onramp/KES" \
  -H "x-api-key: YOUR_CONSUMER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "shortcode": "254712345678",
    "amount": 500,
    "mobile_network": "Safaricom",
    "address": "0xYourWallet",
    "chain": "BASE",
    "asset": "USDC"
  }'

POST

onramp

{currency_code}

curl -X POST "{{base_url}}/v1/onramp/KES" \
  -H "x-api-key: YOUR_CONSUMER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "shortcode": "254712345678",
    "amount": 500,
    "mobile_network": "Safaricom",
    "address": "0xYourWallet",
    "chain": "BASE",
    "asset": "USDC"
  }'

Starts a local collection and, after success, releases crypto to the destination wallet.

string

required

e.g. KES, UGX, GHS, MWK, CDF.

string

required

Customer phone / mobile money number (10 digits for KES/UGX).

number

required

Fiat amount to collect. Limits are per transaction — see Limits.

string

required

Network operator for the market (e.g. Safaricom, Airtel, MTN).

string

required

Destination wallet address for released assets.

string

required

BASE or CELO.

string

required

USDC on BASE; USDT on CELO.

string

Optional webhook URL.

string

Optional client reference.

Amount limits

Per-transaction min/max by currency: Limits.

curl -X POST "{{base_url}}/v1/onramp/KES" \
  -H "x-api-key: YOUR_CONSUMER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "shortcode": "254712345678",
    "amount": 500,
    "mobile_network": "Safaricom",
    "address": "0xYourWallet",
    "chain": "BASE",
    "asset": "USDC"
  }'

⌘I

Overview

Account

Rates

Payments (v1)

Banks

Checkout

Collection & disbursement

Amount limits

​Amount limits

Amount limits