Get Token Prices by Contracts
POST
Retrieves the on-chain market price of tokens issued by the specified ERC20 token contracts. Multiple contracts can be queried, up to a maximum of 100 contracts.
🚧 Getting a 429 error? Check your subscription plan!
429 errors may occur when the Throughput limit of your subscription plan is exceeded.
For example, the Starter plan has a limit of 300 CU per second, so if you use the Starter plan and call an API that consumes 350 CU, you may get a 429 error.
Check the CU consumption of the API you are using on the Compute Unit Costs page, and consider upgrading to a higher plan if you need more Throughput!
🚧 Things to know when querying token prices
Token prices provided by this API are based on CoinMarketCap data. Price information is updated periodically, so it may differ from real-time prices. Additionally, querying tokens not registered on CoinMarketCap will return an empty array.
Path Parameters
chainstringrequired
Parameter specifying the target chain to query.networkstringrequired
Parameter specifying the network of the target chain.Request Body
contractAddressesarrayrequired
Parameter specifying an array of contract addresses to query. Contract addresses can be entered as 40-character hexadecimal strings starting with 0x.currencystring
Parameter for selecting the currency unit for Token Price queries. Supports USD and KRW. Default is USD.Responses
currencystring
A field representing the type of currency used for trading. Provided in ISO 4217 currency code format.pricestring
A field representing the current price of the token. Provided in decimal string format.volumeFor24hstring
A field representing the total trading volume over the past 24 hours. Used as an indicator of active trading activity. Provided in decimal string format.volumeChangeFor24hstring
A field representing the percentage change in trading volume over the past 24 hours. Used as an indicator of market volatility. Provided in decimal string format.percentChangeFor1hstring
A field representing the price change percentage over the past 1 hour. Used as an indicator of short-term market trends.percentChangeFor24hstring
A field representing the price change percentage over the past 24 hours. Used as an indicator of medium-term market trends.percentChangeFor7dstring
A field representing the price change percentage over the past 7 days. Used as an indicator of long-term market trends.marketCapstring
A field representing the market capitalization of the token. Reflects the total market value of the asset. Provided in decimal string format.updatedAtstring
A field representing when the data was last updated. Provided in ISO 8601 format.listingsarray
A field representing the list of exchanges where the token is listed.addressstringrequired
A field representing the contract address.deployedTransactionHashstringrequired
A field representing the hash of the transaction in which the contract was deployed.deployedAtstringrequired
A field representing the time when the contract was deployed. This field is provided in ISO 8601 date and time format.deployerAddressstringrequired
A field representing the address that deployed the contract.logoUrlstringrequired
A field representing the logo URL of the contract. This URL can be used to visually identify the contract. [Note] Not all contracts have logo images available. If a contract has no logo, this field is provided as null.typestringrequired
A field representing the type of the contract. Contract types are denoted by standard specification names (e.g., ERC721, ERC1155, ERC20, ERC721, ERC1155, ERC20).namestringrequired
A field representing the name of the contract. Returns an empty string if the contract does not follow the standard or if name was not provided at contract creation.symbolstringrequired
A field representing the symbol of the contract. Returns an empty string if the contract does not follow the standard or if symbol was not provided at contract creation.totalSupplystring
A field representing the total supply of the contract. This value indicates the total token supply and is provided as a decimal string. Included in the response only when the contract type is ERC20.decimalsinteger
A field representing the decimal places of the contract. Included in the response only when the contract type is ERC20 or ERC1155.codestringrequired
Code identifying the cause of the failed request.messagestringrequired
Detailed message including the name and value of the invalid parameter.{"code": "MISSING_REQUIRED_PARAMETER","message": "Missing required parameter: { PARAMETER_NAME }"}
cURL
curl -X POST 'https://web3.nodit.io/v1/avalanche/mainnet/token/getTokenPricesByContracts' \-H 'Content-Type: application/json' \-H 'X-API-KEY: nodit-demo' \-d '{"contractAddresses": ["0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D","0x60E4d786628Fea6478F785A6d7e704777c86a7c6"],"currency": "USD"}'