Trading Wallets
List, create and rename trading wallets and pick the default one.
Returns a list of trading wallets for the authenticated user. Trading wallets are custodial wallets used for executing trades through Cielo's trading infrastructure. Plans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 5 credits.
Blockchain chain filter (e.g. solana, base).
Include archived wallets.
trueList of trading wallets
okBad request - chain is required
Forbidden - Invalid API key or plan
Internal Server Error
GET /api/trading/wallets?chain=text HTTP/1.1
Host: api.cielo.finance
X-API-KEY: YOUR_API_KEY
Accept: */*
{
"status": "ok",
"data": [
{
"address": "text",
"wallet_name": "text",
"is_default": true,
"is_enabled": true,
"is_archived": true,
"chain": "text",
"balance": 1,
"balance_usd": 1,
"usdc_balance": 1
}
]
}Creates a new trading wallet for the authenticated user on the given chain. Plans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 10 credits.
Blockchain chain (e.g. solana, base). Defaults to solana.
Created trading wallet
okForbidden
Internal Server Error
POST /api/trading/wallets HTTP/1.1
Host: api.cielo.finance
X-API-KEY: YOUR_API_KEY
Accept: */*
{
"status": "ok",
"data": {
"address": "text",
"wallet_name": "text",
"is_default": true,
"is_enabled": true,
"is_archived": true,
"chain": "text",
"balance": 1,
"balance_usd": 1,
"usdc_balance": 1
}
}Returns the default trading wallet for the specified chain. Plans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 5 credits.
Blockchain chain (e.g. solana, base).
Default trading wallet
okBad request - chain is required
Forbidden
Default trading wallet not found
Internal Server Error
GET /api/trading/wallets/default?chain=text HTTP/1.1
Host: api.cielo.finance
X-API-KEY: YOUR_API_KEY
Accept: */*
{
"status": "ok",
"data": {
"address": "text",
"wallet_name": "text",
"is_default": true,
"is_enabled": true,
"is_archived": true,
"chain": "text",
"balance": 1,
"balance_usd": 1,
"usdc_balance": 1
}
}Sets a specific trading wallet as the user's default wallet. Plans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 2 credits.
Trading wallet ID.
Blockchain chain filter.
Wallet set as default
okBad request - wallet_id is required
Forbidden
Internal Server Error
PUT /api/trading/wallets/{wallet_id}/default HTTP/1.1
Host: api.cielo.finance
X-API-KEY: YOUR_API_KEY
Accept: */*
{
"status": "ok",
"data": {
"address": "text",
"wallet_name": "text",
"is_default": true,
"is_enabled": true,
"is_archived": true,
"chain": "text",
"balance": 1,
"balance_usd": 1,
"usdc_balance": 1
}
}Updates the display name of a trading wallet. Plans Included = Basic, Whale, ApiBasic, Builder, Architect, Enterprise Cost per request = 2 credits.
Trading wallet ID.
Blockchain chain filter.
New wallet name (1-100 characters).
My Trading WalletWallet renamed
okBad request - invalid wallet_id or name
Forbidden
Internal Server Error
PUT /api/trading/wallets/{wallet_id}/name HTTP/1.1
Host: api.cielo.finance
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 32
{
"new_name": "My Trading Wallet"
}{
"status": "ok",
"data": {
"address": "text",
"wallet_name": "text",
"is_default": true,
"is_enabled": true,
"is_archived": true,
"chain": "text",
"balance": 1,
"balance_usd": 1,
"usdc_balance": 1
}
}Last updated

