Skip to main content
Create sell orders with POST /api/developer/orders.

​
Request body

​
Required on every order

  • side
  • amount
  • fiatCurrency
  • asset
  • chain

​
Sell orders

For sells, send resolved bank details instead of walletAddress. Required:
  • bankCode
  • accountNumber
  • accountName
Optional but useful:
  • bankName
  • email
  • externalCustomerId
  • developerFeeAddress
  • developerFeePercent
curl -X POST "https://api.ramphub.io/api/developer/orders" \
  -H "x-api-key: rh_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "side": "sell",
    "amount": 10,
    "fiatCurrency": "NGN",
    "asset": "USDT",
    "chain": "base",
    "bankCode": "100004",
    "bankName": "Opay",
    "accountNumber": "1234567890",
    "accountName": "ACCOUNT HOLDER NAME",
    "email": "user@example.com",
    "externalCustomerId": "cust_7f3b8a2d",
    "developerFeeAddress": "0xDeveloperFeeWallet",
    "developerFeePercent": 2.5
  }'
If you do not already have the account holder name, call POST /api/developer/bank-accounts/resolve first and reuse the returned accountName.

​
Response shape

The response includes the tracked RampHub transaction id, the selected provider, and the provider settlement details your app should show next. Common fields:
  • transactionId
  • requestReference
  • side
  • asset
  • chain
  • selectedProvider
  • bestRateUsed
  • providerDetails
  • ourCryptoAddress
  • environment
  • sandbox
  • trackable
{
  "transactionId": "0d4b7fb0-66f7-4a52-9183-7c3fe44f0db2",
  "requestReference": "RH-TX-AB12CD34",
  "side": "sell",
  "asset": "USDT",
  "chain": "base",
  "selectedProvider": "UseBread",
  "bestRateUsed": 1397.17,
  "providerDetails": {
    "status": "AWAITING_PAYMENT"
  },
  "ourCryptoAddress": "0xProviderDepositAddress",
  "environment": "live",
  "sandbox": false,
  "trackable": true
}

​
Rules

  • Save transactionId right away.
  • Use providerDetails for the next step.
  • Use ourCryptoAddress for sell payment instructions when it is present.