Lynx API
Search
K
Comment on page
😎

Wallet Balance

Endpoint

GET /v1/wallets/token-balances

Description

This API allows developers to check the token balance of multiple wallets of a specific contract address.

Parameters

  • contract (required): Contract address of the token.
  • chain (required): The blockchain network the contract is deployed on. (1 for Ethereum, 56 for Binance Smart Chain, 137 for Polygon)
  • wallets (required): A comma-separated list of wallet addresses.

Headers

  • x-api-key (required): A valid API key.

Example

curl -X GET 'curl -X GET "https://api.lynxcrypto.app/v1/wallets/token-balances?contract=0x123456789abcdef&chain=1&wallets=0xabcdef123456789,0xabcdef123456789"'
-H 'x-api-key: <YOUR_API_KEY>'

Response

{
"walletBalances": [
{
"walletAddress": "0x123456789abcdef",
"balance": 1234.5678
},
{
"walletAddress": "0xabcdef123456789",
"balance": 2345.6789
},
...
],
"cumulativeBalance": 12345.678
}

Response Codes

  • 200: Success. Returns the balance for the given wallets on the specified contract address and blockchain network.
  • 400: Bad Request. One of the required query string parameters (contract, chain, or wallets) is missing or invalid.
  • 500: Internal Server Error. An unexpected error occurred while processing the request.
Last modified 10mo ago