😎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 updated