SimpleHash Migration Guide: Seamless Transition with Uniblock

Kevin Callahan

April 30, 2025
CEO

Chief Executive Officer @ Uniblock

Migrate seamlessly from SimpleHash with Uniblock's comprehensive API orchestration layer, offering 1,500+ APIs and intelligent routing across 50+ providers.

SimpleHash Migration Guide: Seamless Transition with Uniblock

The Web3 ecosystem is constantly evolving, with new tools and services emerging while others undergo significant changes. Recently, many developers have found themselves needing to migrate away from SimpleHash's API services. If you're one of those developers, you're likely wondering how to maintain your application's functionality without completely rebuilding your infrastructure.

Good news: Uniblock is here to help make your transition smooth and painless.

Benefits of Switching to Uniblock

Automated API & RPC Orchestration Layer – First of its kind in Web3 development

Extensive Connectivity – Access to 1,500+ APIs, 100+ protocols, and 50+ partners (e.g., Alchemy, Helius, QuickNode, CoinGecko, CoinMarketCap)

Intelligent Routing System – Automatically selects the best provider based on performance, reliability, and cost

Seamless Failover – If a provider has issues, the platform switches to another to ensure uptime

We also offer 1:1 consultation to see how we can let you hit the ground running with us!

Understanding the Migration Approach

When migrating from SimpleHash to Uniblock, there are a couple of important concepts to understand:

Data Normalization – Standardizes responses across providers; some fields may be omitted. Use includeRaw=true to access full raw data.

Endpoint Mapping – Many SimpleHash endpoints have direct counterparts; specialized ones may be replaced by combined solutions or provider-specific access.

Let's dive into the specific migration paths, organized by functionality.

Core NFT Data: Metadata, Collections, and Ownership

NFT Metadata

The heart of many NFT applications is metadata—information about the NFTs themselves. SimpleHash's /nfts/assets, /nfts/{chain}/{contract_address}/{token_id}, and similar endpoints can be replaced with Uniblock's v1/nft/metadata.

One key difference to note: SimpleHash often uses combined formats like chain.contract.token_id, which need to be broken into separate parameters when using Uniblock endpoints.

For example, if you were querying SimpleHash with an NFT ID like ethereum.0x12345...67890.123, you'll need to separate these components into chainId=ethereum, contractAddress=0x12345...67890, and tokenId=123 when using Uniblock.

NFT Collections

Collection data is another critical component for many applications. If you're using SimpleHash's collection endpoints like /nfts/collections/{chain}/{address} or /nfts/{chain}/{contract_address}, you can migrate to Uniblock's v1/nft/collection-metadata.

For collection-level queries, keep in mind that SimpleHash's collection ID system doesn't have a direct parallel in most other providers. If your collection is represented by a single contract, this migration is straightforward. For more complex collections spanning multiple contracts, you might need to adjust your approach.

For Solana collections using Metaplex addresses, we provide access through our Moralis Direct API integration, which offers similar functionality.

NFT Ownership & Balances

Tracking who owns what is fundamental to many NFT applications. SimpleHash's /nfts/owners can be replaced with Uniblock's v1/nft/owners/nft, though note that the quantity field might be missing.

For more advanced ownership queries using SimpleHash's /nfts/owners_v2 or /nfts/balance/advanced, you can use our v1/nft/balance endpoint. While this isn't a comprehensive replacement for all the filtering and sorting options SimpleHash provided, it covers the core functionality. We're actively working on expanding these capabilities.

Market Data: Prices, Volumes, and Trading Activity

Market data provides crucial context for NFTs, enabling features like portfolio valuation and market analysis. This is an area where SimpleHash offered some specialized endpoints that might require combined approaches with Uniblock.

Floor Prices & Collection Activity

For floor prices (SimpleHash's /nfts/floor_prices_v2/collection), you can use Uniblock's v1/nft/floor-price endpoint. This works well for collections represented by a single contract.

Collection activity data is more complex. The SimpleHash /nfts/collections_activity endpoint provided both volume and market cap information. With Uniblock, you can get volume data from Covalent's endpoints and market cap information from CoinGecko—both accessible through our platform.

NFT Listings & Marketplace Data

NFT listing data is critical for marketplace applications. While we don't currently have direct replacements for SimpleHash's listing endpoints, we're actively working on integrating with Reservoir's API to provide similar functionality.

For top collections (by volume or other metrics), you can use Moralis's market-data/nfts/hottest-collections endpoint through our Direct API. Note that this doesn't support time-period filtering like SimpleHash did.

Specialized Use Cases

Some SimpleHash features require more creative solutions when migrating to Uniblock:

Wallet Valuation

For wallet valuation, you can use the Moralis Direct API endpoint for NFT data and sum the values from the list_price.price_usd field for each owned NFT.

Historical Price Data

For historical price data, you can access Covalent's endpoints through our Direct API. Keep in mind that this data is typically available at daily granularity, not hourly like some SimpleHash endpoints.

NFT Price Information

To get comprehensive price information for individual NFTs, you might need to combine data from multiple endpoints:

  • Floor prices from Moralis's floor price endpoint
  • Last sale information from Moralis's price endpoint

Webhook Support

Event-driven architectures rely heavily on webhooks. If you're using SimpleHash's webhook functionality, you can migrate to either Alchemy or Tatum webhooks through Uniblock.

For NFT metadata updates (SimpleHash's contract.nft_metadata_update), Alchemy's NFT Metadata Updates webhook provides a nearly identical replacement.

For collection transfers (SimpleHash's collection.transfer), there's no direct collection-level replacement due to differences in how collections are identified. Instead, you can use Alchemy's NFT Activity webhook to track contract-level events.

Making the Migration Smooth

Based on our experience helping teams migrate, here are some key recommendations:

  1. Start with core functionality: Focus first on migrating essential endpoints that your application depends on most heavily.
  2. Use raw data access: When you need provider-specific fields, use includeRaw=true and specify a provider to access all available data.
  3. Consider batch processing: If you're migrating from endpoints that query multiple assets simultaneously to endpoints that don't support this, consider implementing batch processing in your application.
  4. Test thoroughly: API responses might have subtle differences even when the core data is the same. Test your integrations thoroughly to catch any unexpected behaviors.
  5. Reach out for help: Our team is available to provide guidance and support throughout your migration process.

The Future of Web3 Data Access

This migration represents more than just a change in API endpoints—it's an opportunity to build on a more resilient foundation. With Uniblock's multi-provider approach, you're not just replacing SimpleHash; you're gaining access to a broader ecosystem of data providers without the complexity of managing multiple integrations.

As Web3 continues to evolve, having flexibility in data sources will become increasingly important. By building on Uniblock now, you're positioning your application to adapt more easily to future changes in the ecosystem.

We're Here to Help

Our team is dedicated to making your transition as smooth as possible. If you have specific migration questions or need custom solutions:

  • Contact our support team
  • Join our Discord community
  • Schedule a 1:1 consultation with our developer advocates

We're constantly expanding our offerings to ensure you have all the tools you need to build amazing Web3 applications.

Appendix: SimpleHash to Uniblock Endpoint Reference

NFT Metadata

  • SimpleHash /nfts/assets → Uniblock v1/nft/metadata
  • SimpleHash /nfts/{chain}/{contract_address}/{token_id} → Uniblock v1/nft/metadata
  • SimpleHash /nfts/{chain}/{mint_address} → Uniblock v1/nft/metadata
  • SimpleHash /nfts/solana/{nft_address} → Uniblock v1/nft/metadata

NFT Collections

  • SimpleHash /nfts/collections/{chain}/{address} → Uniblock v1/nft/collection-metadata
  • SimpleHash /nfts/{chain}/{contract_address} → Uniblock v1/nft/collection-metadata or v1/nft/nft-in-collection
  • SimpleHash /nfts/collections/ids → Uniblock v1/nft/collection-metadata
  • SimpleHash /nfts/collection/{metaplex_address} → Moralis Direct API through Uniblock

NFT Ownership & Balances

  • SimpleHash /nfts/owners → Uniblock v1/nft/owners/nft
  • SimpleHash /nfts/owners_v2 → Uniblock v1/nft/balance
  • SimpleHash /nfts/balance/advanced → Uniblock v1/nft/balance

NFT Transfers & Activity

  • SimpleHash /nfts/transfers/wallets → Uniblock v1/nft/transfers

Floor Prices & Collection Activity

  • SimpleHash /nfts/floor_prices_v2/collection → Uniblock v1/nft/floor-price
  • SimpleHash /nfts/collections_activity → Combination of Covalent and CoinGecko endpoints
  • SimpleHash /nfts/{chain}/{contract_address}/{token_id}/hourly or /daily → Covalent API through Uniblock

Token Pricing

  • SimpleHash /fungibles/prices_v2 → Uniblock /token/price/historical

Uniblock gives developers superpowers with instant access to 1,500+ APIs, 100+ protocols, and 50+ partners, all within a single unified platform. Save thousands on your monthly data costs while building smarter, faster, and with complete control over your Web3 stack.

Start your Web3 Development with Uniblock

Use our full suite of products to help jumpstart your development into Web3.
Try Uniblock today for free!