Skip to main content
POST
/
api
/
v3
/
onramp
/
crypto
Send Token to Crypto Wallet
curl --request POST \
  --url https://sandbox-api.kotanipay.com/api/v3/onramp/crypto \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "receiverAddress": "<string>",
  "cryptoAmount": 123,
  "referenceId": "<string>",
  "callbackUrl": "<string>"
}
'
{
  "success": true,
  "message": "Request has been successfully created",
  "data": {
    "referenceId": "<string>",
    "status": "<string>",
    "cryptoAmount": 123,
    "cryptoAmountReceived": 123,
    "feeInCrypto": 123,
    "feeType": "<string>",
    "cryptoWallet": "<string>",
    "chain": {},
    "token": {},
    "amountToSend": 123,
    "transactionHash": "<string>"
  }
}
This endpoint will send token to any crypto wallet address specified.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
receiverAddress
string
required

The receiver address of the onramp crypto transaction

​
chain
enum<string>
required

The chain of the onramp crypto transaction

Available options:
ETHEREUM,
CELO,
AVALANCHE,
POLYGON,
ARBITRUM,
OPTIMISM,
STELLAR,
TRON,
FUSE,
LIGHTNING,
SOLANA,
PROVENANCE,
CARDANO,
HEDERA,
BASE,
LISK,
VICTION,
SCROLL
​
token
enum<string>
required

The token of the onramp crypto transaction

Available options:
CUSD,
USDC,
USDT,
USDT0,
SAT,
BTC,
HASH,
FUSE,
HBAR,
USDGLO,
CKES,
CGHS,
MSAT,
XLM,
ADA
​
cryptoAmount
number
required

The amount of crypto sent

​
referenceId
string
required

The reference ID of the onramp crypto transaction

​
callbackUrl
string

Webhook URL to notify when the crypto transfer completes or fails.

Response

​
success
boolean
Example:

true

​
message
string
Example:

"Request has been successfully created"

​
data
object