Polygon Amoy is now available across all of our APIs and Streams API!
Polygon Amoy replaces Polygon Mumbai and we highly recommend that developers switch to Polygon Amoy as soon as possible. Polygon Mumbail will be deprecated on 29th April 2024.
Polygon Amoy Chain Details:
chain query parameter: polygon amoy or 0x13881EvmChain.POLYGON_AMOYCheck-out all our supported chains here.
We’ve just launched our Wallet History endpoint, allowing you to fetch a wallet's full transaction history, fully decoded, labelled and enriched with a single API call 🤯
With support for over 15 categories, such as Token Swap, NFT Sale, Mint, Burn and many more, this endpoint is a total game-changer for anyone building a wallet or activity feed 🔥
This endpoint includes several query parameters:
chain: Choose the blockchain to query 🌐from_block and to_block: Set the block range for the transactions you're interested in 📊. If both from_date and from_block (or to_date and to_block) are provided, the block parameter takes precedence.from_date and to_date: Specify the date range for transactions. Accepts seconds or date strings compatible with moment.js 📅.internal_transactions: Include internal transactions in your results when set to true ✅.nft_metadata: Include NFT metadata in your results when set to true ✅.cursor: Use this to paginate through results, utilizing the cursor provided in the previous response 🔄.order: Sort the results in ascending (ASC) or descending (DESC) order 🔢.limit: Adjust the page size of your results to your preference 📏.Check-out the API reference for more information
Today we're super excited to announce the launch of ERC20 Token Owners 🤩
This endpoint allows you to instantly fetch all owners of a given ERC20 token, sorted by highest holders first, letting you quickly understand the top holders of a token.
For each token holder, gain insights into their wallet balance, whether they are a contract or not, their owner address, label, USD value, and their percentage relative to the total token supply 🔥
Here's an example response:
{
"balance": "10930056627204137678149589",
"balance_formatted": "10930056.627204137678149589",
"is_contract": false,
"owner_address": "0x6cc5f688a315f3dc28a7781717a9a798a59fda7b",
"owner_address_label": "OKX",
"usd_value": "116329685.478903487324714661",
"percentage_relative_to_total_supply": 1.0930056627204137
}
Test it out yourself and start building today 🚀
We’ve got some big token logo news for our Token API ✨
Say goodbye to outdated token visuals - we're bringing industry-leading coverage of EVM token logos to Moralis!
All of our Token API endpoints are now fully enriched with the latest token logos 🤩
No matter whether you're fetching ERC20 transfers, tracking token balances or fetching real-time prices; all endpoints now include token logos optimized for your frontend applications 🔥
On April 5th, 2024, we plan to deprecate Ethereum Goerli testnet and therefore advise customers to switch over to Ethereum Holesky testnet as soon as possible.
Following Ethereum Goerli's deprecation on March 13th 2024, we will also fully remove support for Ethereum Goerli on April 5th. Customers that are currently still using Ethereum Goerli for historical transaction data are strongly advised to migrate to Ethereum Holesky as soon as possible.
Ethereum Holesky chain details:
chain query parameter: holesky or 0x4268EvmChain.HOLESKYCheck-out all our supported chains here.
Today we're excited to unveil a series of enhancements to our Market Data API, including two new endpoints, making our data even more accessible and comprehensive. And the best part? All these features are now available to our free plan users as well! 🤩
Dive deeper into the crypto market with our latest additions:
We've enriched our existing endpoints with valuable data points to offer you a more detailed market overview:
collection_address: returns the token address for the NFT Collectionfloor_price: returns the floor price in the native currency (in addition to the previously supported floor_price_usd)floor_price_usd_24hr_percent_change: returns the percentage change in the USD floor price, over a 24-hour periodcollection_address: returns the token address for the NFT Collectionaverage_price: returns the average native price this collection has sold for, considering all sales, in the last 24 hoursfloor_price: returns the floor price in the native currency (in addition to the previously supported floor_price_usd)floor_price_usd_24hr_percent_change: returns the percentage change in the USD floor price, over a 24-hour periodfloor_price_7d_percent_change: returns the percentage change in the native currency floor price, over a 7-day periodfloor_price_usd_7d_percent_change: returns the percentage change in the USD floor price, over a 7-day periodfloor_price_30d_percent_change: returns the percentage change in the native currency floor price, over a 30-day periodfloor_price_usd_30d_percent_change: returns the percentage change in the USD floor price, over a 30-day periodAll these enriched features and data points are now part of our free plan, ensuring that everyone has access to comprehensive market insights. 🎉
Explore the Updated Market Data API Docs for more information.
On March 29th, 2024, we plan to deprecate Base Goerli testnet and therefore advise customers to switch over to Base Sepolia testnet as soon as possible.
Following Base Goerli's deprecation on February 9th 2024, we will fully remove support for Base Goerli on March 29th. Customers that are currently still using Base Goerli for historical transaction data are strongly advised to migrate to Base Sepolia as soon as possible.
Base Sepolia chain details:
chain query parameter: base sepolia or 0x14a34EvmChain.BASE_SEPOLIACheck-out all our supported chains here.
We’ve just launched our Wallet Net-worth endpoint, allowing you to fetch the USD value of a wallet, across all chains and assets, with a single API call 🤯
This endpoint features three query parameters:
chains: specify multiple chains 🥳exclude_spam: when set to true, this will exclude spam tokens from the calculation (recommended)exclude_unverified_contracts: when set to true, this will exclude tokens that are not verified on CoinGecko (recommended)Check-out the API reference for more information, and see this endpoint in action over on our YouTube channel.
We've launched a new endpoint for fetching ERC20 tokens by wallet which includes token balances, metadata, USD prices and a whole lot more for every token 🤩
Compared to our regular token balances endpoint, this endpoint includes the following extra data points per token:
balance_formatted: decimal formatted balanceusd_price: current price of the tokenusd_price_24hr_percent_change: 24hr change as a percentageusd_price_24hr_usd_change: 24hr change in usd valueusd_value: the value of the wallet's holdingsusd_value_24hr_usd_change: 24hr change in value of the wallet's holdingsportfolio_percentage: the percentage that this token represents of the wallet's token portfolionative_token: this can be true or false and is used to identify the chain's native tokenIt also includes some powerful new query parameters:
exclude_spam: when set to true this will exclude all tokens marked as spam from the response (defaults to false)exclude_unverified_contracts: when set to true this will exclude all tokens that are not verified on Coingecko (defaults to false)exclude_native: when set to true this will exclude the chain's native token from the holdings (defaults to false)Check-out the API reference for more information, and see this endpoint in action over on our YouTube channel.
Today we've launched a number of enhancements to our NFT collection endpoints 🔥 They include:
verified_collection status across more chainsWe've added the following properties to our NFT Collection metadata:
collection_logocollection_banner_image collection_categoryproject_urlwiki_urldiscord_urltelegram_urltwitter_usernameinstagram_usernameEnhanced metadata can be found on the following endpoints:
Our verified_collection status, which was previously only supported on Ethereum, is now available on these additional chains:
This status reflects whether or not the collection has been verified on OpenSea.
We've introduced a new query parameter when fetching NFT Collections by wallet call token_counts. When set to true, this will add the total number of NFTs held in each collection by the wallet to the response data.
We've added a new endpoint, Get metadata for multiple NFT Collections, that allows you to fetch metadata for up to 25 NFT collections in one request.
Today we've launched filtering and sorting across the many of our transfer and transaction endpoints 🚀
Wallet transfer endpoints can now be filtered by specific contract addresses (one or many), allowing you to filter results down to specific contract(s). You'll find a new query parameter called contract_addresses on the following endpoints:
All of our transfer and transaction endpoints can now be ordered by date asc/desc. Previously, all endpoints were sorted by desc as default, giving you the latest transactions first. Now, you can order these endpoints with order=asc to get the earliest transactions first. You'll find a new query parameter called order on the following endpoints:
On March 4, 2024, we will phase out our old public RPC URLs specific to WalletConnect within the earlier version of the Moralis JS SDK (v1). This update affects users that are currently using WalletConnect in the frontend who have not opted for a custom RPC URL. The RPC URLs slated for discontinuation follow the format: https://speedy-nodes-nyc.moralis.io/WalletConnect/eth/mainnet.
If you have already upgraded to our latest version of the JS SDK, or you do not use the WalletConnect feature in our v1 SDK, your operations will remain unaffected. For those still using these specific URLs, transitioning to a custom RPC URL is required. This can be easily achieved by updating the rpcMap parameter in the Moralis.authenticate method.
Summary and Migration Guide To migrate from the soon-to-be-retired speedy nodes, users are required to replace these deprecated URLs with an alternative RPC provider. This process involves specifying your chosen provider's RPC URL in the rpcMap parameter during authentication with Moralis. This change ensures continuous and uninterrupted service following the deprecation date. Please refer to our migration guide for more information.
We're excited to announce that our Optimism integration is now live across all our Web3 APIs 🔥
Add Optimism support in seconds by simply including the new optimism chain identifier.
Read more about our Optimism integration.
We've launched a new endpoint that allows you to fetch SPL Token metadata on Solana 🔥
In the same way you could already fetch NFT metadata, it's now possible to fetch metadata for all SPL tokens. For each token we return:
We are aware of a bug on our current NFT Metadata endpoint, which returns SPL Token metadata for certain tokens. If you are using the NFT endpoint in this way, we strongly advise that you begin using the new SPL Token Metadata endpoint.
Try it out over on our Solana swagger.
The wait is over! We're excited to announce that we are now live with our Base integration across our entire product suite 🔥
Add Base support to your dapps in seconds by simply including the new base chain identifier.
Read more about our Base integration.
Starting today, September 11th, 2023, we're implementing a series of significant API changes to v2 of our EVM API as described in an earlier post. Some of these changes are breaking changes, but will ultimately provide you with a faster, more reliable, and more consistent experience.
If you are on API v2 and are impacted by these changes you can find a comprehensive migration guide here.
For those who have transitioned to v2.2, rest assured that your operations remain unaffected by these updates.
We’re excited to announce that v2.2 of our EVM API is officially live and ready for immediate integration into your applications.
As part of v2.2, we've introduced 5 new endpoints designed to provide total counts for popular use-cases related to Wallets, NFTs, ERC20s and Blocks. These endpoints are particularly valuable for those who will be impacted by the breaking changes coming to v2 in September, and are available now allowing for a smooth migration:
/api/v2.2/wallets/{address}/stats/api/v2.2/erc20/{address}/stats/api/v2.2/nft/{address}/stats/api/v2.2/nft/{address}/{token_id}/stats/api/v2.2/block/{block_number_or_hash}/statsThese new endpoints can be found at our latest v2.2 swagger https://deep-index.moralis.io/api-docs-2.2
We initially announced that breaking changes would be rolled out on September 4th. However, in order to maximize the window for you to integrate these new endpoints, we're pushing the date for breaking changes to September 11th. This gives you two weeks to integrate the new endpoints into your applications, as previously outlined in our earlier post.
Starting from September 11th, v2 will still be operational, but it will incorporate the announced breaking changes and deprecated endpoints will be removed. For most customers who are not impacted by these updates, it's perfectly safe to continue using v2. However, we strongly recommend upgrading to the latest version to benefit from all the new features and improvements.
v2.2 is now availablev2.2.v2 safely.Our NFT API now includes a new property called verified_collections 🎉 This property can be true or false, and reflects whether or not the collection has been verified on OpenSea. This new property can be found on all NFT endpoints.
Additionally, we have added a new query parameter called exclude_spam. When this is set to true, any NFTs that have been marked as spam will be excluded from the API response. This query parameter is currently available on get NFTs by wallet as well as get NFT collections by wallet.
Beginning on September 11th, 2023, we're implementing a series of significant API changes, some of which are breaking changes, but will ultimately provide you with a faster, more reliable, and more consistent experience.
These changes are:
total field in the response body and the disable_total query parameter will be removed from a number of endpoints. Customers who have already stopped using these features following earlier updates will not be affected. The affected endpoints include getTokenTransfers, getNFTs, getWalletNFTCollections, getNFTTrades, getNFTTransfers, getContractNFTTransfers, getNFTOwners, getTokenAddressTransfers, getWalletTokenIdTransfers, getAllTokenIds, getNFTTransfersFromToBlock, getNFTTransfersByBlock, getTokenIdOwners, getTransactions, getContractEvents.direction query parameter is being removed from the getNFTTransfers endpoint.getLogsByAddress endpoint, the topic0 field will now be required, and we will be removing the topic1, topic2, and topic3 fields.searchNFTs, getErc20Mints, getErc20Burns, getErc20Transfers, getErc20Approvals.If you are affected by these changes you can find a detailed migration guide here.
These changes will improve the speed, consistency, and scalability of our API, making it easier for you to work with whilst laying the foundations for what’s coming next… In the short term, expect enhancements like wallet net-worth, NFT prices and ERC20 holders. Rest assured, more improvements are on the way very soon!
Check out our Roadmap to stay up-to-date with all of the features we have coming soon.
Our ERC20 transfers, NFT transfers and transaction endpoints have just got an upgrade!
All endpoints that currently return a to_address and/or from_address will now include an additional to_address_label and from_address_less respectively 🤩
These labels reflect publicly known addresses such as Coinbase, Binance, Uniswap v3, 1inch etc; as well as specific addresses such as Uniswap v2: Router 2 🔥
Perfect for adding extra detail into your wallet applications and transaction analytics 🙌
From today you can now easily establish a wallet's age as well as detect which chains it has been active on 🔥
This latest endpointadded to our Wallet API, /wallets/{address}/chains, is our first truly cross-chain API. Rather than the usual chain query parameter, it has a new chains parameter, allowing you to specify one or many chains in one API call 🤩
For each chain that a wallet has been detected on, we return its first_transaction details and last_transaction details.
Perfect for wallet analytics, user engagement, wallet age gated sites plus so much more 🙌
Today we're excited to announce a number of improvements to our ERC20 price endpoints 🎉
We've added a new endpoint, /erc20/prices, that allows you to fetch the prices of up to 25 ERC20s in one API call. No more fetching prices one by one 😍
We've added 24hrPercentChange to all of our price endpoints, so you can now easily fetch a token's 24 hour performance. We've introduced a new query parameter, include=percent_change, which when included will add 24hrPercentChange to the response body. Note: using this query parameter incurs an additional cost of +5 CUs per request.
No more displaying ugly prices 🫣 We've added usdPriceFormatted to our price endpoints meaning you'll always be returned with prices in a nice clean decimal format (for example, 3.0526340931742754e-8 will appear as 0.00000003052).
Today we've launched a new endpoint that allows you and the users of your dapps to submit contracts for review.
Easily report new spam contracts by specifying report_type as spam, or request a re-review of misclassified contracts with a report_type of not_spam.
Submissions will be reviewed and incorporated into our spam library, and reflected across our ERC20 and NFT API endpoints.
Today we're extremely excited to announce the launch of a new product, our Market Data API! 🚀
Our Market Data API allows you to explore the latest trends in NFT collections, keep an eye on the top coins, and monitor the largest ERC20 gainers and losers.
We're introducing four new endpoints with this launch, including:
Check out our docs for more information about these new endpoints, as well as how to share feedback for its next iteration.
Today we have enriched all our ERC20 endpoints with extra metadata including token name, symbol, icon, and decimals 🎉
Developers can now more easily identify the specific ERC20 tokens involved in transfers, mints, burns, and approvals without having to make additional API calls.
Previously, token metadata were only available through the ERC20 metadata endpoint.
This metadata is now available on the following endpoints:
Our Resolve API now supports Ethereum Name Service (ENS) lookup by domain. This new feature allows you to input a .eth domain and receive the associated Ethereum address 🎉
To use this new endpoint, simply make a GET request to /api/v2/resolve/ens/{domain} with your desired .eth domain appended.
For example, if you want to look up the address for vitalik.eth, you would make a GET request to: /api/v2/resolve/ens/vitalik.eth, which would return the address 0x057Ec652A4F150f7FF94f089A38008f49a0DF88e.
We're excited to announce the launch of our new spam detection feature across our EVM APIs!
Our latest update adds a new field called possible_spam to all ERC20s and NFTs. This field returns true or false, depending on whether the contract address is associated with spam, phishing attempts, or suspicious activities.
This feature is currently available on our EVM API and will soon be launching on our Streams API 🔥 Stay tuned!
Check out our docs for more information about this feature including which endpoints it's active on.
Time to optimize your NFTs!
All NFTs served through our API now include an optional media object that includes low, medium and high resolution thumbnails, along with the original image 🎉
This makes it super easy to build apps and webpages that are optimized for speed and that load in a flash ⚡
Today we have launched four new ERC20 token endpoints allowing you to quickly fetch mints, burns, approvals and transfers for any wallet or contract address 🚀
These endpoints have no required inputs or query parameters, meaning we return all on-chain transactions by default. Each endpoint supports flexible filtering by wallet address, contract address and even addresses to exclude (see more about filtering below).
Today we have launched version 1 of our new transaction decoding and labeling feature 🥳
This feature automatically decodes raw transaction input data into human-readable events and then labels each transaction and log, allowing you to quickly identify on-chain activity such as Transfer, Swap, Deposit etc.
Transaction labeling can be found on the following two endpoints:
Head over to our docs for more information about how this works.
We’re excited to announce that today we have launched internal transactions across a number of our most popular EVM chains!
Real-time and historical internal transactions are now available across Ethereum, Sepolia, Polygon, Mumbai, BNB and BNB testnet. For complete coverage, please see the table outlined here.
Internal transactions have been added on three existing endpoints by introducing a new query parameter include that supports internal_transactions as an input:
We have also launched a new endpoint that specifically fetches internal transactions for a given transaction hash:
Read more: /web3-data-api/evm/internal-transaction
As outlined in an earlier update, today we've made a change to the default behaviour of disable_total on a number of endpoints in order to vastly improve their response times.
This flag now defaults to true and the total response will be returned as null. Customers wanting to continue using the total will need to specify disable_total=false in their requests.
In order to vastly improve the response times on a number of endpoints (by up to x10!), we are planning to phase out support for total within our API responses.
A new flag called disable_total exists on the below endpoints which defaults to false. When users set this to true, the total count from the response will return as null, and the endpoint's response time is greatly improved. We strongly recommend to begin using this flag.
Today we've shipped a new EVM feature Get native balances for multiple wallets!
You can now specify a list of wallet addresses to easily fetch the native balance per wallet, as well as the overall total balance in one API call.
Docs: https://docs.moralis.io/web3-data-api/evm/reference/get-native-balances-for-addresses
Block filtering has been aded to getNFTContractTransfers endpoint /api/v2/nft/{address}/transfers 🎛️
It's now possible to filter by blocks on the getNFTContractTransfers endpoint and fetch NFT contract transfers between two blocks, by specifying from_block & to_block.
Docs: /web3-data-api/evm/reference/get-nft-contract-transfers
We've just shipped a new EVM feature Get Multiple NFTs, meaning you can now specify a list of NFTs to return in one API call. ⚡
It was already possible to fetch all NFTs by wallet address or by collection address, but now it's possible to fetch specific NFTs across many different collections by specifying a list of collection IDs + token IDs. 🎉
More CUs for our amazing customers!
After considerations on the great demand of the getTokenIdOwners endpoint, we understand that a lot of our users are very keen to make full use of this endpoint.
Therefore, we have decided to reduce our CU cost for /nft/{address}/{token_id}/owners (getTokenIdOwners) from 20 CUs down to 5 CUs.
Try out the endpoint here!
Token and NFT name and symbol are now always returned on the below endpoints. 🎉
/account/:network/:tokens /web3-data-api/solana/reference/get-spl /account/{network}/{address}/nft /web3-data-api/solana/reference/get-sol-nfts /account/:network/:address/portfolio /web3-data-api/solana/reference/get-sol-portfolio
Arbitrum is now fully-integrated to Moralis EVM API endpoints. You can now index NFT, Token, and other-blockchain related data from the Arbitrum Layer-2 Network by specifying chain parameter value as arbitrum or 0xa4b1.
One API - all transactions and logs. ✨ Use our Verbose Transaction Endpoint and save yourself the hassle of multiple API calls. What's more, this Transaction API endpoint extracts data sequenced by block number. Organized - just how you like it.
We have launched a new endpoint /{address}/verbose which for a given wallet address will return all transactions, and for each transaction all its logs.
Palm Network is now fully-integrated to Moralis EVM API endpoints. You can now index NFT, Token, and other-blockchain related data from the Palm Network by specifying chain parameter value as palm or 0x2a15c308d
We just made working with NFT metadata a breeze! 💨 Get predictable, structured outputs at each endpoint thanks to our new built-in NFT API Metadata Normalization.
Taking the original source metadata field, which comes through the API as a string with an unpredictable format, we now output this into a nice clean, predictable object on the below endpoints - meaning it's now much easier for you to work with NFT metadata!
You'll find a new query parameter named normalizeMetadata on the below endpoints. When this is set to true, we normalize and transform the source metadata into a standardized structure (based on ERC721, CryptoPunks, OpenSea etc) and output this in a new object called normalized_metadata
Endpoints
/{address}/nft/nft/{address}/nft/{address}/owners/nft/{address}/{token_id}/nft/{address}/{token_id}/owners