Onramp

​

Prerequisites

• An active customer with a virtual account that holds the fiat to convert (Add virtual accounts).
• For a Conduit wallet destination, an active wallet for the asset and chain you want (Add a crypto wallet). For an external wallet, nothing: the customer needs no Conduit wallet and signs nothing.
• A customer outside the United States. On live, an onramp for a customer in the United States returns 403 CAPABILITY_SUSPENDED; sandbox does not apply this refusal (Customers in the United States).
• Your API key.

​

Choose the destination

​

Send to a Conduit wallet

curl https://api.conduit.financial/v2/orders \
  -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "idempotency-key: $(uuidgen)" \
  -H "content-type: application/json" \
  -d '{
    "source": { "type": "virtual_account", "id": "vac_..." },
    "destination": {
      "type": "wallet",
      "id": "wlt_...",
      "asset": { "code": "USDC", "chain": "ethereum" }
    },
    "lockSide": "source",
    "amount": "100.00",
    "autoExecute": true
  }'

​

Send to a wallet outside Conduit

curl https://api.conduit.financial/v2/orders \
  -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "idempotency-key: $(uuidgen)" \
  -H "content-type: application/json" \
  -d '{
    "source": { "type": "virtual_account", "id": "vac_..." },
    "destination": {
      "type": "external_wallet",
      "asset": { "code": "USDC", "chain": "ethereum" },
      "purpose": "payment_for_goods_or_services",
      "recipient": {
        "chain": "ethereum",
        "address": "0xYourExternalAddress",
        "attestation": { "custody": "self" }
      }
    },
    "lockSide": "source",
    "amount": "100.00",
    "autoExecute": true
  }'

• recipient is the crypto recipient of POST /v2/payouts. recipient.chain must equal asset.chain.
• attestation.custody is required. Use self when the customer owns the wallet. For a wallet that belongs to someone else, use third_party and add the owner’s identity: type, plus firstName, lastName and countryOfCitizenship, or legalName and countryOfRegistration.
• purpose and documents follow the same rules as a payout (Transact). A purpose of intercompany or personal_transfer_of_funds needs the address registered first (Registered Addresses).
• autoPayout and sourceAsset are refused with an external_wallet destination.
• To see the recipient fields before you build the request, call GET /v2/orders/requirements with recipientRail=crypto and the destination asset and chain.

​

Track the order

​

See also

• Quote before you order — price the onramp before you create it.
• Take your own margin — add your own margin to an onramp you resell.
• Send a payout — send crypto you already hold to an external address.