Changelog

We’re pleased to announce a more robust contract verification process, now featuring a dedicated Etherscan verification status check and final result reporting. This means you can confidently verify your contracts—proxy or otherwise—knowing you’ll receive a much more clear outcome every time.
Added Verification Status Check and Final Result Return
- Introduced extra logic to check for verification status on Etherscan-like explorers, which polls for verification completion.
- This now returns the final verification result (e.g., "success," "failure," or "already verified") instead of just the receipt GUID.
Fixed Constructor Parameter Fetching for Proxy Contracts
- Fixed some corner cases where we should use the implementation address when verifying proxied contracts with constructor parameters.
We hope this streamlined verification workflow reduces the friction of contract verifications and helps you focus on delivering great applications. Happy building!

We're excited to announce an important update to our RPC edge infrastructure at thirdweb. This enhancement is designed to improve performance and reduce costs for our users.
- Response Compression at RPC Edge:
We’ve enabled response compression, meaning our RPC endpoints now deliver compressed responses to reduce data size and speed up transmission. - Cost Reduction for Users:
With smaller payloads, users can enjoy reduced bandwidth usage and lower overall costs when interacting with our servers. - New Request Requirement:
To take full advantage of this update, you need to add anAccept-Encoding
header to your requests. This tells our servers that your client can handle compressed responses.
Simply include the Accept-Encoding
header in your API requests. For instance, if you're calling the eth_blockNumber
method using our RPC endpoint, you can use the following curl example:
In this example:
- The
Accept-Encoding: gzip
header signals that your client accepts gzip-compressed responses. - The JSON payload makes a call to
eth_blockNumber
to retrieve the latest block number.
This update is part of our continuous effort to enhance performance and efficiency. We’re committed to providing you with the best tools and infrastructure for your development needs. If you have any feedback or questions, please don’t hesitate to reach out.

We're excited to announce that thirdweb Insight has expanded its blockchain data querying capabilities to 61 chains, including these 19 new chains:
- zkSync
- Mantle
- Abstract mainnet and testnet
- Zora
- World
- Hedera
- Laos
- Rivalz
- Basecamp
- Beam
- Sonic
- Cronos zkEVM
- Taiko mainnet and testnet
- Celo testnet
- Arena Z testnet
- Treasure Topaz testnet
- Monad testnet
What This Means For Developers
With these additions, you can now use all of Insight's powerful features across these new chains.
Try them out on the playground!
View All Supported Chains
For a complete list of supported chains and their respective chain IDs, check the thirdweb chainlist.
📖 Learn more about Insight - it’s open source and ready to power your applications!

You can now view the list all sponsored transactions across in a team by going to your Team > Usage Page in thirdweb dashboard

You can also view this table in your Team > Project > Connect > Account Abstraction > Analytics page to see only sponsored transactions for the selected project


The thirdweb SDK comes with built-in tree-shaking, meaning your application only keeps what it uses from the SDK. However, we still like to keep the overall package size as small as possible for convenience while you're running your application in development. With version 5.92.0 we've reduced the package install size by more than 25%, from 199 MB to 144 MB. See the latest here.
Unfortunately, this means we've had to remove support for 3D models in the media renderer. You can still display 3D model NFTs in your application using our IPFS resolvers and Three.js or a similar library.
We're excited to announce the release of additional NFT API endpoints to Insight. These endpoints provide comprehensive APIs for accessing NFT metadata, transfers, ownership information, and more. The NFT API provides a great alternative for developers looking to migrate from SimpleHash, which is expected to shutdown on March 27th.
The endpoints below are now available to use.
Retrieve all NFTs from a specific contract address.
Fetch data for a specific NFT using its contract address and token ID.
List all NFTs owned by a specific wallet address across all contracts.
Track all transfer events for a specific NFT contract with optional metadata.
View the complete transfer history for a specific NFT token with optional metadata.
Retrieve all NFT transfers that occurred within a specific transaction with optional metadata.
List all current owners of NFTs from a specific contract.
Identify the current owners of a specific NFT token.

We’re excited to introduce significant upgrades Nebula's transaction execution. Our latest model, t0-003, is more capable, accurate, and intelligent—enabling seamless execution of complex, multi-step prompts.
With expanded support for bridging, swapping, and multi-transaction workflows, developers can now perform actions like retrieving balances, executing transfers across chains, and handling approvals in a single streamlined process.
- New model:
t0-003
— more capable, higher accuracy and smarter- Supports complex prompts that involve multi-step instructions
- For example:
- Bridging and swapping with more chains and more token routes supported
- Supports multiple transactions, for example, approve and transfer. Wallets will need to execute the transactions in order.
- The chat completion API may consist of multiple
unsigned_transaction
in theactions
Nebula is currently in Alpha for a select number of developers. For access to the product, please sign up on the Nebula waitlist.
For any feedback or support inquiries, please visit our support site.

Querying token prices in USD is now supported by Insight API!
Try it out in our playground

To fetch a token's price by its contract address
(0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
is used for native tokens)
Response
You can optionally define a timestamp and the API will return the closest data it has to that timestamp.
To fetch token prices by symbol
Note that there can be multiple tokens with the same symbol
We support more than 6000 tokens currently and keep adding more.
We also provide an endpoint to fetch the list of supported tokens for each chain.

📖 Learn more about Insight - it’s open source and ready to power your applications!

Insight API will deprecate all camelCase fields from responses and remove them by 30th of March 2025. Every field that was previously in camelCase has a duplicate field in snake_case for the time being, allowing users to migrate their response handling.
List of affected fields:
decodedData
- New name:
decoded
- Affected endpoints
v1/transactions
(in case ofdecode=true
query param)v1/transactions/:contractAddress
(in case ofdecode=true
query param)v1/transactions/:contractAddress/:signature
v1/events
(in case ofdecode=true
query param)v1/events/:contractAddress
(in case ofdecode=true
query param)v1/events/:contractAddress/:signature
- New name:
decodedData.indexedParams
anddecoded.indexedParams
- New name:
indexed_params
- Affected endpoints
v1/events
(in case ofdecode=true
query param)v1/events/:contractAddress
(in case ofdecode=true
query param)v1/events/:contractAddress/:signature
- New name:
decodedData.nonIndexedParams
anddecoded.nonIndexedParams
- New name:
non_indexed_params
- Affected endpoints
v1/events
(in case ofdecode=true
query param)v1/events/:contractAddress
(in case ofdecode=true
query param)v1/events/:contractAddress/:signature
- New name:
chainId
- New name:
chain_id
- Affected endpoints
v1/tokens/erc20/:ownerAddress
v1/tokens/erc721/:ownerAddress
v1/tokens/erc1155/:ownerAddress
- New name:
tokenAddress
- New name:
token_address
- Affected endpoints
v1/tokens/erc20/:ownerAddress
v1/tokens/erc721/:ownerAddress
v1/tokens/erc1155/:ownerAddress
- New name:
tokenId
- New name:
token_id
- Affected endpoints
v1/tokens/erc721/:ownerAddress
v1/tokens/erc1155/:ownerAddress
- New name:
Example of a decoded data response
It should be noted that the properties in indexed_params
and non_indexed_params
could be any format, because they are based on how the smart contract was programmed.
Example of a token response
📖 Learn more about Insight - it’s open source and ready to power your applications!

We’re excited to share that Thirdweb now better aligns with Etherscan’s latest V2 API. If you regularly need to have your contracts verified on Etherscan-like explorers, this change means a more streamlined, less error-prone experience - so you can spend more time shipping, and less time wrestling with parameters. One click on the Thirdweb dashboard is all it takes!

- V2 API Readiness: Our system automatically targets Etherscan V2 endpoints for the correct chain, minimising manual setup and reducing the possibility of misconfiguration.
- Future-Proofing: This approach lays the groundwork for supporting additional block explorer APIs with minimal friction, ensuring that Thirdweb utilities remains flexible and up-to-date.
The goal behind these changes is to make verifying your smart contracts as hassle-free as possible. By cutting down on repetitive parameters and streamlining the integration with Etherscan V2, we’ve drastically reduced the chance of errors. Ultimately, we want you to focus on the things that matter—innovating, building, and delivering great blockchain experiences.
We’re always improving our developer experience, so if you have any questions or feedback, reach out to us. In the meantime, we hope you enjoy the smoother, more robust contract verification process!

Insight now serves NFT assets through the Thirdweb Gateway, improving retrieval times by caching the content on a globally serving data on edge. Instead of referencing IPFS or Arweave links, insight automatically resolves them to edge-friendly endpoints, so metadata no longer displays IPFS URLs. This deployment works seamlessly with the existing NFT schema without requiring any additional steps. It enhances performance, reduces latency, and ensures consistent, high-speed access to decentralized assets.
Example:
before:
After
This means you can use the image directly in your frontend, the snippet bellow would render the NFT image from thirdweb gateway.



Effective Date: March 3, 2025, at 3:00 PM PST
Announcing some important changes to our mint fee process that further standardize our fee structure for all new contract deployments. We are introducing a 1% protocol fee applied to all contracts, and adjusting the convenience fee to 1.5% from previous 2.5%.
We believe this change strikes the right balance between a standardized protocol fee and the flexibility for custom fee settings, making fee management easier and more transparent for everyone.
Please note this change does not effect already deployed contracts.
- Fixed protocol fee:
All new deployments now include a non-overridable 1% protocol fee. This fee is implemented into the contract and will always apply if deployed through SDK, dashboard, or third-party integrations. For example, an asset listed at 0.1 ETH will distribute 0.099 ETH to the seller and 0.001 ETH to the platform. - Convenience Fee:
When deploying via dashboard, the fee includes a 1.5% convenience fee or 2.5% total (1% protocol fee plus an additional 1.5%). For example, an asset listed at 0.1 ETH will distribute 0.0975 ETH to the seller and 0.0025 ETH to the platform. - Custom Fee Configuration:
You can still set your own platform fee during deployment or later via our platform. The process works exactly as before, with the custom fee now being applied in addition to the fixed thirdweb fee.
This adjustment helps support continued development and maintenance of prebuilt smart contracts, ensuring reliability, security, and innovation for the ecosystem.
For any questions or further details, please reach out to our support team.
- Which prebuilt contracts will have included fees?
- The following contracts and corresponding modular versions will now include a seller fee:
- Drop Contracts:
DropERC20
,DropERC721
,DropERC1155
,OpenEdition
- Token Contracts:
TokenERC20
,TokenERC721
,TokenERC1155
- Specialized Contracts:
LoyaltyCard
,BurnToClaim
,MarketplaceV3
- Drop Contracts:
- The following contracts and corresponding modular versions will now include a seller fee:
- I deployed a contract prior to the effective date, will these fees apply to me?
- This fee is only applied to any contracts deployed after 3:00 pm PST on March 3, 2025

We Introduced a new include_spam
query parameter to the ERC20 token endpoint to filter out potential spam tokens.
The criteria for identifying spam include:
• Empty token name
• Empty token symbol
• Symbol length greater than 15 characters
• Zero decimals
By default, spam tokens are excluded from responses (include_spam=false
). You can try it in our playground by visiting here. See the example bellow:

Here is a Typescript example showing how to use it in your code:

We are now supporting NFT metadata for Insight NFT balance endpoints (ERC-721 and ERC-115).
By adding metadata=true
query parameter to the request, the response will include metadata about the NFT - name, description, image URL, background color, external URL, collection and contract info in addition to the balance.
Here's an example of the data that can be returned:
Try it out on our playground

Or call it directly from code
📖 Learn more about Insight - it’s open source and ready to power your applications!
The Insights API now supports querying contract metadata and ABIs. Powered by our contract indexing and verification backend, developers can now access verified contract metadata and ABIs for all supported chains directly within Insights. This eliminates the need to interact with block explorers and third party source code verifiers to get contract metadata and ABIs.
We've added the following endpoints:
Get contract ABI

Get contract metadata

Both endpoints are available in the playground to test.
Stay tuned for more updates and exciting features from Thirdweb!

We’re excited to unveil a powerful addition to the thirdweb platform: a brand-new API designed to automate chain onboarding in real time. This release is especially useful for Rollup-as-a-Service (RaaS) providers, who can now seamlessly integrate new chains into the thirdweb ecosystem the moment they’re spun up. No more back-and-forth or manual listing processes—this API provides a streamlined way to manage your chains on thirdweb.
- Automated Registration of Newly Spun-Up Chains
Our new API endpoints let you programmatically add or update chain configurations on the thirdweb platform. This is critical for RaaS providers who rapidly deploy new chains and need an immediate, frictionless connection to thirdweb. - Seamless Integration with Existing Workflows
Because the API is designed for simplicity, it easily slots into your existing DevOps workflow. You can add a single API call to your chain deployment scripts, automatically informing thirdweb about the new chain’s details—no manual steps required. - Real-Time Updates
Once your chain is registered, the thirdweb platform reflects the changes immediately, so developers can start using thirdweb tools (SDKs, CLIs, and dashboards) on your newly created chains right away. - Robust Documentation and Tooling
We’ve launched an accompanying API Reference that covers everything you need—from authenticating requests to building complex integration flows. You’ll find clear examples, success and error response codes, and best practice guidelines.
Below are some of the most commonly used endpoints. A full list of endpoints and usage examples can be found in the API docs.
- POST
/chains
Register a new chain with thirdweb. Supply essential metadata (e.g., chain name, chain ID, explorer URLs, stack type and custom RPC urls) for immediate onboarding. - GET
/chains
Fetch details about chains added by your team. Useful for verifying that your chains has been successfully added and has all the relevant info present. - PUT
/rpcUrls/{chainId}
Add RPC urls for an existing chain, very requested by RaaS providers.
- Speedy Deployment: Spin up a new rollup chain and instantly register it with thirdweb in a single automated step.
- Less Overhead: No more waiting on manual reviews or dealing with miscommunications. Your chain data stays in sync whenever you roll out a new version or fork.
- Scalability: Whether you have one chain or a thousand, the API is built to handle bulk provisioning and updates.
- Review the Documentation
Check out the API docs for quickstart guides and detailed references. - Generate an API Key
Obtain an API key from your thirdweb dashboard. This key will authenticate your requests. - Integrate With Your Deployment Scripts
Add API calls to your RaaS deployment pipeline or CI/CD workflow to register new chains automatically. - Test & Monitor
Use the provided sandbox environment or your standard staging area to test new chain registrations before rolling out changes to production.
We’re committed to making thirdweb the most developer-friendly platform for emerging blockchain solutions. Here’s a sneak peek at what’s coming next:
- Account Abstraction
Automate provisioning and integration with your custom account abstraction flows for enhanced security and better user experiences. - Universal Bridge (previously thirdweb Pay)
Simplify asset transfers across different chains with an automatically provisioned, interoperable payment/bridge layer. - Insight
Gain real-time analytics and diagnostics across all your chains—insightful dashboards and metrics will be automatically enabled for new rollups.
Expect these features—along with additional endpoints, analytics hooks, and security enhancements—to be part of our continued effort to streamline multi-chain support.
Stay tuned for details and in the meantime, don't hesitate reaching out to get early access and needed permissions to be able to utilise this and give us feedback!
As always, thank you for building with thirdweb!

We’re introducing metadata retrieval in our ERC20 token API!
You can now include token information—such as name, symbol, and decimals—in a single call to our /tokens/erc20 endpoint. Just add the new metadata=true parameter to the query string. For example:
GET /v1/tokens/erc20/vitalik.eth&metadata=true
This returns the token’s metadata along with the usual balance data, simplifying your workflows and saving you from making extra calls. We’ve also added caching so metadata lookups are faster after the first request.
You can try it in our playground by visiting here. See the example bellow:

Here is a Typescript example showing how to use it in your code:

Insight API added support for querying block data.
Try it out on our playground

Or use it directly from code
📖 Learn more about Insight - it’s open source and ready to power your applications!

Insight API now supports an explorer-like endpoint to resolve blockchain data.
The resolve endpoint supports
- Transaction hashes - returns the transaction data
- Block hashes - returns the block data
- Addresses (also ENS names)
- In case of an EOA - returns last 20 transactions from that address
- In case of a contract - returns last 20 transactions to that address
- Event signatures - returns the latest 20 events with the given signature
- Function signatures - returns the latest 20 transactions with the given signature
Try it out on our playground

Or use it directly from code
This endpoint was initially called v1/search/:input
but was changed to v1/resolve/:input
to better reflect its purpose.
📖 Learn more about Insight - it’s open source and ready to power your applications!

At thirdweb, innovation is in our DNA. We’re excited to share a behind-the-scenes look at how our team is continuously pushing the boundaries to deliver an unparalleled user experience. Today, we're diving into some key upgrades that have transformed our RPC server.
We’ve made a bold move by switching our RPC server to the Bun runtime. This isn’t just a technological upgrade—it’s a leap toward efficiency. With this change, we’ve managed to slash memory usage by 30%. What does that mean for you? More network requests are handled seamlessly, ensuring a smoother and more responsive experience without the need for extra hardware.

Performance matters, and every millisecond counts. By introducing short-term caching into our architecture, we’ve dramatically reduced latency. Our metrics tell the story:
- P90 latency is down by 50%.
- P95 latency has improved by a whopping 300%.
These numbers translate into faster response times and a more robust service, even during peak usage periods.
Understanding every nuance of our system is key to delivering excellence. We’ve integrated fine-grained our Performance Monitoring that drills down into every RPC call. This means we now track method-level usage and latency, giving us a crystal-clear view of performance across the board. With this insight, we’re empowered to act swiftly, optimizing our service before issues can arise.