Simple

Token Price by Token Addresses

This endpoint allows you to get token price based on the provided token contract address on a network

get/simple/networks/{network}/token_price/{addresses}

Request

  • Base URL: https://api.geckoterminal.com/api/v2
  • URL: https://api.geckoterminal.com/api/v2/simple/networks/{network}/token_price/{addresses}
  • Auth: none declared

Path parameters

networkstring required
Example:eth

network ID<br>*refers to /networks

addressesstring required

token contract address, comma-separated if more than one token contract address (up to 30 addresses)

Query parameters

include_market_capboolean

include market capitalization

mcap_fdv_fallbackboolean

return FDV if market cap is not available

include_24hr_volboolean

include 24hr volume

include_24hr_price_changeboolean

include 24hr price change

include_total_reserve_in_usdboolean

include total reserve in USD

include_inactive_sourceboolean

include inactive pools when sourcing for token's top pool

Response

Get current USD prices of multiple tokens on a network

Example response

{
  "data": [
    {
      "data": {
        "id": "1ba898f0-eda2-4291-9491-9a5b323f66ef",
        "type": "simple_token_price",
        "attributes": {
          "token_prices": {
            "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "2289.33"
          },
          "market_cap_usd": {
            "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "6692452895.779648"
          },
          "h24_volume_usd": {
            "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "965988358.733808"
          },
          "h24_price_change_percentage": {
            "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "3.3870290336"
          },
          "total_reserve_in_usd": {
            "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1576179559.94669772339136684208"
          }
        }
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.