User Balance by Discord ID

This endpoint relies on CARV ID to establish the relationship between the provided Discord ID and the corresponding blockchain address. If the specified discord_user_id is not connected to any address through CARV ID, the API will not be able to retrieve the expected result. Ensure that the Discord account is properly linked to a blockchain address via CARV ID before making a request.

GET UserBalanceByDiscordID

GET /ai-agent-backend/user_balance_by_discord_id

Params

Name	Location	Type	Required	Description
discord_user_id	query	string	no	none
chain_name	query	string	no	"ethereum"
token_ticker	query	string	no	none
Authorization	header	string	yes	login token in redis
Origin	header	string	yes	none

Description

• chain_name: Supported values include "ethereum_mainnet", "base_mainnet", "solana_mainnet", "opbnb_mainnet" (and all testnets as well).

Example Request (HTTP)

GET /ai-agent-backend/user_balance_by_discord_id?discord_user_id=123456&chain_name=ethereum_testnet&token_ticker=aave
Authorization: <your-auth-token>

Response Examples

{
  "code": 0,
  "msg": "Success",
  "data": {
    "balance": "0.010000"
  }
}

400 Response

{
  "error": "string"
}

Responses

HTTP Status Code	Meaning	Description	Data schema
200	OK	none	Inline
400	Bad Request	none	Inline

Responses Data Schema

HTTP Status Code 200

Name	Type	Required	Restrictions	Title	description
» code	integer	true	none		none
» msg	string	true	none		none
» data	object	true	none		none
»» balance	string	true	none		none

HTTP Status Code 400

Name	Type	Required	Restrictions	Title	description
» error	string	true	none		none