Skip to main content
POST
/
api
/
v3
/
wallet
/
crypto
Create a Crypto wallet
curl --request POST \
  --url https://sandbox-api.kotanipay.io/api/v3/wallet/crypto \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "My Wallet",
  "chain": "eg CELO or ETHEREUM or AVALANCHE or POLYGON"
}
'
{
  "success": true,
  "message": "Wallet has been successfully created.",
  "data": {
    "name": "My Wallet",
    "balance": 1000,
    "type": "eg crypto or fiat",
    "coin": "eg CUSD or USDC or USDT",
    "id": "f053188c-d924-4423-bbba-871eda0b1cd9",
    "address": "0x1234567890",
    "customAddress": "0x1234567890",
    "chain": "eg CELO or ETHEREUM or AVALANCHE or POLYGON",
    "tokenBalance": [
      {
        "token": "USDT",
        "balance": "1000",
        "fiatValue": "1000"
      }
    ],
    "fiatBalance": 1000,
    "fiatCurrency": "USD"
  }
}
Create a crypto wallet to hold specified blockchain assets. The crypto wallet will contain the specified chain and coins that an integrator desires to hold, and you can create as many wallets as needed.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
name
string
required

The name of the wallet

Example:

"My Wallet"

​
chain
enum<string>

The chain of the wallet.Its required if the wallet is a crypto wallet

Available options:
ETHEREUM,
BSC,
CELO,
AVALANCHE,
POLYGON,
ARBITRUM,
OPTIMISM,
STELLAR,
TRON,
FUSE,
LIGHTNING,
SOLANA,
PROVENANCE,
CARDANO,
HEDERA,
BASE,
LISK,
VICTION,
SCROLL,
STABLE
Example:

"eg CELO or ETHEREUM or AVALANCHE or POLYGON"

Response

​
success
boolean
Example:

true

​
message
string
Example:

"Wallet has been successfully created."

​
data
object