Tokens API

Endpoints for managing tokens, balances, and price data.

Endpoints

Get Token List / Balances

GET /list

Retrieve a list of all tokens with balances for a wallet on a specific chain.

Query Parameters:

Parameter	Type	Required	Description
walletAddress	string	Yes	User wallet address
chainId	number	Yes	Chain ID

Response Fields:

Field	Type	Description
name	string	Token name
symbol	string	Token symbol
address	string	Token contract address
decimals	number	Token decimals
balance	string	Raw balance
logoURI	string	Token logo URL

---

Search Token

GET /searchToken

Search for tokens by name, symbol, or contract address.

Query Parameters:

Parameter	Type	Required	Description
query	string	Yes	Search term (name, symbol, or address)
chainId	number	Yes	Chain ID

---

Get USD Price

GET /getUSDPrice

Get the current USD price for a specific token.

Query Parameters:

Parameter	Type	Required	Description
tokenAddress	string	Yes	Token contract address
chainId	number	Yes	Chain ID

Response:

{
  "price": 3245.67,
  "priceChange24h": 2.45,
  "priceChange7d": -1.23,
  "marketCap": 389000000000,
  "volume24h": 15600000000
}