Initiating Transaction - Welcome to Saber Money

Sell cryptocurrency (USDT or USDC) for fiat (currently INR) via bank transfer, using the fiat/sell endpoint.

Initiate Sell Transaction

Endpoint: Sell: POST /api/v1/wallet/conversion/fiat/sell Pool Sell: POST /api/wallet-services/v2/transaction/pool/sell Sample request:

curl --location 'https://api.saber.money/api/v1/wallet/conversion/fiat/sell' \
  --header 'X-Timestamp: {{timestamp}}' \
  --header 'X-Client-Id: •••••••' \
  --header 'X-Secret-Key: •••••••' \
  --header 'X-Request-Id: {{request_id}}' \
  --header 'X-User-Id: •••••••' \
  --data '{
    "source_id": "65d246fc-6a5b-43d7-89bf-944e95ff2279",
    "fiat_symbol": "INR",
    "crypto_symbol": "USDT",
    "crypto_amount": 1.14,
    "payment_method": "bank_transfer"
  }'

Sample response:

{
  "success": true,
  "data": {
    "status": "CREATED",
    "fiat_amount": "100",
    "transaction_type": "SELL",
    "fiat_symbol": "INR",
    "failure_code": "",
    "exchange_rate": "0",
    "id": "a892dc4a-aecb-4a22-9de4-2990b4179b77",
    "crypto_symbol": "USDT",
    "created_at": 1664783475000,
    "failure_desc": "",
    "crypto_amount": "1.14"
  }
}

Required Parameters

Parameter	Description
`source_id`	The unique wallet address ID of the user initiating the transaction.
`fiat_symbol`	Fiat currency to receive. Currently only `INR` is supported.
`crypto_symbol`	Crypto to sell — `USDT` or `USDC` (others available on request).
`crypto_amount`	Amount of crypto to sell. Required (Pool Sell may use `quote_id` instead).
`payment_method`	Must be `bank_transfer`.

Response Parameters

Field	Description
`success`	Whether the request succeeded.
`status`	Transaction status — `CREATED`, `PENDING`, `COMPLETED`, etc.
`fiat_amount`	Fiat amount, as a string. Monetary/rate fields (`fiat_amount`, `crypto_amount`, `exchange_rate`) are serialized as JSON strings — parse as decimals, not numbers.
`transaction_type`	`SELL` for the standard endpoint, `POOL_SELL` for the pool endpoint.
`fiat_symbol`	Fiat currency symbol (`INR`).
`exchange_rate`	Conversion rate, as a string. `"0"` at creation for standard Sell; populated for Pool Sell.
`id`	Unique transaction ID.
`crypto_symbol`	Crypto symbol sold (e.g. `USDT`).
`crypto_amount`	Amount of crypto sold.
`reason_code`	Present only when applicable.
`created_at`	Unix epoch milliseconds (int64).
`failure_code` / `failure_desc`	Present only on failure; empty strings on success.

Notes

INR is currently the only supported fiat currency; bank_transfer the only payment method.
Only USDT or USDC can be sold — other cryptocurrencies are available on request.
Sell can also be initiated directly from the pool wallet through this API — the request body is the same, but see Pool Sell transaction status for the different create/status endpoints.

API Reference: Create Sell Transaction

Related topics

Initiating Transaction Understanding the Platform Overview Traditional Rails

⌘I