Quick Start

Prerequisites

Get API Keys

Sandbox API Key: For testing
Production API Key: For live transactions (after KYB approval)

Verify Connectivity

curl https://api.sandbox.daya.co/health

Pick a flow to get started:

NGN to Crypto (Onramp)
Crypto to NGN (Offramp)

Accept Naira and settle as stablecoins

1. Fetch a BUY rate

Get a firm quote for converting NGN to USDC:

curl --request GET \
  --url 'https://api.sandbox.daya.co/v1/rates?from=NGN&to=USDC&side=BUY' \
  --header 'X-Api-Key: YOUR_SANDBOX_API_KEY'

{
  "rate_id": "rate_8x7k2mq9p",
  "from": "NGN",
  "to": "USDC",
  "side": "BUY",
  "rate": 1545.50,
  "expires_at": "2026-01-14T15:35:00Z"
}

Save the rate_id — it’s valid for ~30 minutes and you’ll need it to create the onramp.

2. Create an onramp

Provision a temporary virtual account that your customer will pay into:

curl --request POST \
  --url https://api.sandbox.daya.co/v1/onramps \
  --header 'X-Api-Key: YOUR_SANDBOX_API_KEY' \
  --header 'X-Idempotency-Key: onramp-001' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "TEMPORARY",
    "customer": { "email": "user@example.com" },
    "rate_id": "rate_8x7k2mq9p",
    "amount": 1500000,
    "settlement": {
      "mode": "ONCHAIN",
      "asset": "USDC",
      "chain": "ETHEREUM",
      "destination_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
    }
  }'

{
  "type": "TEMPORARY",
  "onramp_id": "onramp_3j5k8n2q",
  "customer_id": "650e8400-e29b-41d4-a716-446655440000",
  "rate_id": "rate_8x7k2mq9p",
  "rate_expires_at": "2026-01-14T15:35:00Z",
  "settlement": {
    "mode": "ONCHAIN",
    "asset": "USDC",
    "chain": "ETHEREUM",
    "destination_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
  },
  "virtual_account": {
    "account_number": "0690000031",
    "bank_name": "Wema Bank",
    "account_name": "Daya - user@example.com",
    "expires_at": "2026-01-14T15:25:12Z"
  }
}

Show your customer the virtual account details so they can make the transfer.

The virtual account expires in ~20 minutes. Deposits after expiry will be flagged.

3. Simulate a deposit (Sandbox)

In sandbox, trigger a test deposit using the sandbox deposit endpoint.

4. Track the deposit

Poll the deposits endpoint, or better yet, set up webhooks:

curl --request GET \
  --url 'https://api.sandbox.daya.co/v1/deposits?onramp_id=onramp_3j5k8n2q' \
  --header 'X-Api-Key: YOUR_SANDBOX_API_KEY'

{
  "deposits": [
    {
      "type": "NGN_DEPOSIT",
      "id": "dep_9x2k5m8p",
      "onramp_id": "onramp_3j5k8n2q",
      "amount": "15000.00",
      "currency": "NGN",
      "settled_amount": "9.70",
      "settled_currency": "USD",
      "status": "COMPLETED",
      "settlement_mode": "ONCHAIN",
      "chain": "ETHEREUM",
      "tx_hash": "0x8f3e2d1c..."
    }
  ]
}

Receive stablecoins and settle as Naira

1. Resolve the bank account

Before creating an offramp with NGN payout, verify the destination bank account:

curl --request POST \
  --url https://api.sandbox.daya.co/v1/banks/resolve \
  --header 'X-Api-Key: YOUR_SANDBOX_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "account_number": "0690000031",
    "bank_code": "044"
  }'

{
  "account_number": "0690000031",
  "account_name": "JOHN DOE"
}

Invalid bank accounts will be rejected when creating the offramp. Always resolve first.

Sandbox bank accounts: Use account numbers starting at 0690000031 (increment the last digit: 0690000032, 0690000033, etc.) with bank code 044.

2. Fetch a SELL rate

Get a firm quote for converting crypto to NGN:

curl --request GET \
  --url 'https://api.sandbox.daya.co/v1/rates?from=NGN&to=USDC&side=SELL' \
  --header 'X-Api-Key: YOUR_SANDBOX_API_KEY'

{
  "rate_id": "rate_5m2k9x7p",
  "from": "NGN",
  "to": "USDC",
  "side": "SELL",
  "rate": 1520.00,
  "expires_at": "2026-01-14T15:35:00Z"
}

3. Create an offramp

Generate a deposit address and configure NGN payout settlement using the resolved bank details:

curl --request POST \
  --url https://api.sandbox.daya.co/v1/offramps \
  --header 'X-Api-Key: YOUR_SANDBOX_API_KEY' \
  --header 'X-Idempotency-Key: offramp-001' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "TEMPORARY",
    "customer": { "email": "user@example.com" },
    "chain": "ETHEREUM",
    "asset": "USDC",
    "settlement": {
      "mode": "NGN_PAYOUT",
      "rate_id": "rate_5m2k9x7p",
      "destination_bank": {
        "account_name": "JOHN DOE",
        "account_number": "0690000031",
        "bank_code": "044"
      }
    }
  }'

{
  "id": "a50e8400-e29b-41d4-a716-446655440000",
  "type": "TEMPORARY",
  "customer_id": "650e8400-e29b-41d4-a716-446655440000",
  "address": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef12",
  "chain": "ETHEREUM",
  "asset": "USDC",
  "status": "ACTIVE",
  "settlement": {
    "mode": "NGN_PAYOUT",
    "rate_id": "rate_5m2k9x7p",
    "destination_bank": {
      "account_name": "JOHN DOE",
      "account_number": "0690000031",
      "bank_code": "044"
    }
  },
  "created_at": "2026-01-14T15:05:00Z",
  "updated_at": "2026-01-14T15:05:00Z"
}

Share the address with your customer — they send USDC to it, and Daya converts and pays out NGN to the bank account.

4. Track the deposit and payout

When crypto lands at the deposit address, Daya creates a deposit and a corresponding payout:

curl --request GET \
  --url 'https://api.sandbox.daya.co/v1/deposits?offramp_id=a50e8400-e29b-41d4-a716-446655440000' \
  --header 'X-Api-Key: YOUR_SANDBOX_API_KEY'

{
  "deposits": [
    {
      "type": "CRYPTO_DEPOSIT",
      "id": "dep_4m7n3k9q",
      "offramp_id": "a50e8400-e29b-41d4-a716-446655440000",
      "amount": "10.00",
      "currency": "USDC",
      "settled_amount": "15200.00",
      "settled_currency": "NGN",
      "status": "COMPLETED",
      "settlement_mode": "NGN_PAYOUT",
      "asset": "USDC",
      "chain": "ETHEREUM",
      "tx_hash": "0xa1b2c3d4..."
    }
  ]
}

Track the NGN payout separately:

curl --request GET \
  --url 'https://api.sandbox.daya.co/v1/payouts?type=NGN_PAYOUT' \
  --header 'X-Api-Key: YOUR_SANDBOX_API_KEY'

Or subscribe to payout.settled and payout.failed webhook events for real-time updates.

Set Up Webhooks

Instead of polling, receive real-time updates for both flows:

Configure your webhook URL in the dashboard
Listen for lifecycle events:

{
  "event": "deposit.settled",
  "timestamp": "2026-01-14T15:08:15Z",
  "data": {
    "type": "NGN_DEPOSIT",
    "id": "dep_9x2k5m8p",
    "onramp_id": "onramp_3j5k8n2q",
    "status": "COMPLETED",
    "settlement_mode": "ONCHAIN",
    "chain": "ETHEREUM",
    "tx_hash": "0x8f3e2d1c..."
  }
}

See the full Webhooks Guide for all event types and payload shapes.

Common Issues

rate_id expired

Rates are valid for ~30 minutes. Always fetch a fresh rate right before creating an onramp or offramp.

Deposit flagged after transfer

Deposits after the virtual account expires are flagged. Ensure customers complete transfers promptly.

Invalid destination address

Verify the address format matches the specified chain. See Supported Chains.

Invalid bank account rejected

Always resolve bank accounts with POST /v1/banks/resolve before using them in offramp settlement. Invalid accounts are rejected at offramp creation.

Next Steps

Core Concepts

Understand onramps, offramps, deposits, and payouts

Authentication

Secure your API requests

Supported Chains

View all supported networks and tokens

Getting Started

Core Concepts

Virtual Account Types

Guides

Rates & Chains

Customers

Onramps

Offramps

Deposits

Payouts

Recipients

Banks

Merchant Balance

Webhooks

Prerequisites

Accept Naira and settle as stablecoins

1. Fetch a BUY rate

2. Create an onramp

3. Simulate a deposit (Sandbox)

4. Track the deposit

Receive stablecoins and settle as Naira

1. Resolve the bank account

2. Fetch a SELL rate

3. Create an offramp

4. Track the deposit and payout

Set Up Webhooks

Common Issues

Next Steps

Core Concepts

Authentication

Supported Chains

Getting Started

Core Concepts

Virtual Account Types

Guides

Rates & Chains

Customers

Onramps

Offramps

Deposits

Payouts

Recipients

Banks

Merchant Balance

Webhooks

​Prerequisites

​Accept Naira and settle as stablecoins

​1. Fetch a BUY rate

​2. Create an onramp

​3. Simulate a deposit (Sandbox)

​4. Track the deposit

​Receive stablecoins and settle as Naira

​1. Resolve the bank account

​2. Fetch a SELL rate

​3. Create an offramp

​4. Track the deposit and payout

​Set Up Webhooks

​Common Issues

​Next Steps

Core Concepts

Authentication

Supported Chains

Prerequisites

Accept Naira and settle as stablecoins

1. Fetch a BUY rate

2. Create an onramp

3. Simulate a deposit (Sandbox)

4. Track the deposit

Receive stablecoins and settle as Naira

1. Resolve the bank account

2. Fetch a SELL rate

3. Create an offramp

4. Track the deposit and payout

Set Up Webhooks

Common Issues

Next Steps