1. Wallet
Corvus API
  • Token
    • Get Token
      POST
  • User
    • Wallet
      • Query user ledger balance
        GET
  • Position
    • My positions with pagination
      GET
  • Market Data
    • Get match team information
      GET
    • Get match team information in batch
      POST
    • Get market price history
      GET
    • Get order books in batch
      POST
    • Get topic market groups
      GET
    • Get topic event list
      GET
    • Get historical events in the same topic series
      GET
    • Get topic event details
      GET
  • Order
    • My orders with pagination
      GET
    • Create prediction buy order
      POST
    • Create prediction sell order
      POST
  • Schemas
    • ErrorResponse
    • WalletBalanceResponse
    • WalletAccountBalanceVo
    • DepositAddressVo
    • PositionListResponse
    • PositionVo
    • TeamsQueryBo
    • TeamsResponse
    • MatchTeamsVo
    • PriceHistoryResponse
    • PriceHistoryPointVo
    • OrderBookQueryBo
    • OrderBooksResponse
    • OrderBookVo
    • OrderBookEntry
    • TopicGroupsResponse
    • TopicMarketGroupVo
    • MarketEventsResponse
    • MarketDetailResponse
    • MarketItemVo
    • EventMarketVo
    • OrderListResponse
    • PredictionOrderListVo
    • PredictionOrderCreateBo
    • PredictionSellOrderCreateBo
    • PredictionOrderResponse
    • PredictionOrderVo
  1. Wallet

Query user ledger balance

GET
/api/balance
Returns the available balance, frozen balance, total balance, and currently available deposit address of the current logged-in user from the system ledger. The balance comes from the internal system ledger rather than a real-time snapshot of an on-chain subaccount. User identity is resolved from the login session, so userId is not required.

Request

Authorization
OAuth 2.0
Password
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
or
Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://ourcorvus.com/api/balance' \
--header 'Accept-Language: zh_CN' \
--header 'clientId: 8e06704235ad224b8b2af4eeb95580a9' \
--header 'Authorization: Bearer <token>'

Responses

🟢200
application/json
Query successful
Bodyapplication/json

Example
{
    "code": 200,
    "msg": "Operation successful",
    "data": {
        "availableBalance": 128.5,
        "frozenBalance": 12,
        "totalBalance": 140.5,
        "currency": "USD",
        "depositAddress": "8n3RkM9sE4d6xQxSxYV9o1Qh2LwP9zM6vA2tYpQf3Hk",
        "depositAddresses": [
            {
                "chain": "SOLANA",
                "displayName": "Solana",
                "network": "mainnet",
                "address": "8n3RkM9sE4d6xQxSxYV9o1Qh2LwP9zM6vA2tYpQf3Hk",
                "supportedTokens": [
                    "USDC",
                    "USDT"
                ]
            }
        ]
    }
}
🔴500
🟠401Unauthorized
Modified at 2026-05-19 06:30:26
Previous
Get Token
Next
My positions with pagination
Built with