Info Endpoint

The Superstack wallet API provides an endpoint to retrieve information about the current API key and the associated user. This is useful for programmatically verifying the permissions, and other metadata of user API keys.

Endpoint: GET <https://wallet-service.superstack.xyz/api/info>

Headers:

• Authorization: Bearer <YOUR_API_KEY>

• Content-Type: application/json

REST API

curl -X GET <https://wallet-service.superstack.xyz/api/info> \\
-H "Authorization: Bearer <YOUR_API_KEY>" \\
-H "Content-Type: application/json"

Rust SDK

use superstack_rust_sdk::SuperstackApiClient;

#[tokio::main]
async fn main() {
    let api_key = std::env::var("API_KEY").unwrap();
    let client = SuperstackApiClient::new(&api_key);

    let api_info = client.get_api_info().await.unwrap();
    println!("API information: {:?}", api_info);
}

Successful Response (Status Code: 200)

{
  "user_info": {
    "id": "6c888719-5e83-4ba7-81b3-432ba501f1f9",
    "wallets": [
      {
        "address": "y26ft6rWWoKdD2beLHhKqxrAM1sg1h23KDU6TBwt2aq",
        "network": "Solana",
        "wallet_set": "Main"
      },
      {
        "address": "0x111ff6433fcf757e1b2324bb5eed3f6973bcfc11",
        "network": "Ethereum",
        "wallet_set": "Main"
      }
    ]
  },
  "api_info": {
    "id": "c09ecb70-6df8-4024-a365-cbc6494b0464",
    "created_at": 1758895380,
    "ip_whitelist": null,
    "permissions": 1
  }
}

Error Response (Status Code: 401 Unauthorized)

{
    "error": "Authentication failed, invalid API key"
}

Error Response (Status Code: 403 Forbidden)

{
    "error": "API key does not have view permission"
}

Permission Table

The permissions field is a bitmap. The returned permissions raw value is the sum of the permissions. For example, a value of 3 means both VIEW and TRADING permissions.

Permission Combination	Raw Value
VIEW	1
VIEW | TRADING	3
VIEW | TRANSFER	5
VIEW | TRADING | TRANSFER	7

Note: User will have multiple wallets, for example, Ethereum and Solana wallets. Superstack uses the Ethereum main wallet for all Hyperliquid actions.