Get ERC20 or Ethereum balance of an address

Let's get the ERC20 Token balance of an ethereum address

  1. You need basic knowledge of how to code with PHP (or know someone who can), you can also learn it at Codecademy.
  2. Create a Tokengateway.io account (if you don't have one already).
  3. Install the PHP 7 modules JSON and CURL. If you are on a Linux Debian/Ubuntu machine, you can use the following commands:
    apt-get install php7-curl
    apt-get install php7-json
    Now restart Apache with:
    service apache2 restart
  4. Now create a file named gettokenbalance.php with the following content (or download it here):
    $apikey = "YOURAPIKEY";
    $ethereumaddress = "ETHEREUMADDRESS"; // Ethereum address you want the balance of
    $contractaddress = "CONTRACTADDRESS"; // Smart contract address of the Token
    # -------------------------------------------------------

    # Define function endpoint
    $ch = curl_init("https://eu.api.

    # Setup request to send json via POST. This is where all parameters should be entered.
    $payload = json_encode( array("apikey" => $apikey, "ethereumaddress" => $ethereumaddress, "contractaddress" => $contractaddress) );
    curl_setopt( $ch, CURLOPT_POSTFIELDS, $payload );
    curl_setopt( $ch, CURLOPT_HTTPHEADER, array('Content-Type:application/json'));

    # Return response instead of printing.
    curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );

    # Send request.
    $result = curl_exec($ch);

    # Decode the received JSON string
    $resultdecoded = json_decode($result, true);

    # Print the Token balance to the screen
    echo $resultdecoded['balance'];
  5. Replace YOURAPIKEY in the above code with the API Key in your Account panel.
  6. Replace the other variables in the upper section of the code above with your data
  7. Upload the created PHP script to your web server
  8. Call the script in your browser. For example, if you upload it to the root directory of your website, you can call it by typing yourwebsite.com/gettokenbalance.php
  9. After a few seconds, the script will return a balance
  10. Congratulations! You just checked the Token balance of an ethereum address.
  11. If you want to automatically receive balance updates when there is a deposit, please check out this tutorial.