Skip to content
Stove Website

Query Platform Statistics ​

Endpoint Information ​

Endpoint: GET /api/v1/stats

Description: Get platform statistics, including user count, order count, and stock token count

Authentication: Accessible anonymously

Request Parameters ​

FieldTypeRequiredDescription
chain_idsstringNoChain ID list, comma-separated, e.g., 56,177,1672,42161. Queries all chains if not provided

Response Parameters ​

FieldTypeDescription
total_user_addressesintUser count
total_ordersintOrder count
total_instrumentsintStock token count on specified chains (sum when multi-chain)
total_balancestringThe sum of all users' holdings on the platform (unit: wei)
total_minted_tokensstringQuery the total number of tokens minted (i.e., the cumulative sum of executed buy orders)
total_market_valuedecimalTotal market value of all positions on the platform

Request Example ​

bash
# Query statistics for all chains
curl -X GET "/api/v1/stats" \
     -H "Content-Type: application/json"

# Query statistics for multiple chains (BSC,HashKey and Pharos)
curl -X GET "/api/v1/stats?chain_ids=56,177,1672" \
     -H "Content-Type: application/json"

Response Example ​

json
{
    "code": 0,
    "data": {
        "total_user_addresses": 1250,
        "total_orders": 5430,
        "total_instruments": 150,
        "total_balance": "497438",
        "total_minted_tokens": "672273",
        "total_market_value": 1544.32
    }
}