Skip to main content

​
What is data consensus?

Data consensus verifies API response data by querying multiple blockchain providers and comparing their responses. This ensures the data you receive is accurate, consistent, and free from provider-specific errors or anomalies. Use data consensus when you need:
  • Guaranteed data accuracy for critical operations
  • Protection against provider data errors
  • Verification of financial data (prices, balances)
  • Confidence in high-stakes transactions
Data consensus is automatically enabled for all Uniblock users.

​
How it works

When data consensus is enabled, Uniblock follows this process:
  1. Primary request - Query your primary provider
  2. Parallel verification - Simultaneously query 2-3 additional providers
  3. Compare responses - Analyze data from all providers
  4. Detect outliers - Identify responses that deviate significantly
  5. Return consensus - Provide verified data based on majority agreement

​
Why data consensus matters

​
Without data consensus

A single provider error can cause critical issues:
Provider returns incorrect price
{
  "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "symbol": "USDC",
  "price": 25.0 // ❌ Should be $1.00
}
Consequences:
  • Incorrect portfolio valuations
  • Failed trading decisions
  • User trust issues
  • Financial losses

​
With data consensus

Errors are detected and filtered: 
Provider A: $1.00 ✅
Provider B: $1.01 ✅
Provider C: $25.00 ❌ (outlier detected)

Consensus result: $1.00
Benefits:
  • Accurate data guaranteed
  • Outliers automatically filtered
  • Confidence in critical operations
  • Protection against provider bugs

​
Supported endpoints

Data consensus works with these endpoint categories:

​
Token endpoints

  • ✅ Token prices
  • ✅ Token balances
  • ✅ Token transfers
  • ✅ Token allowances

​
NFT endpoints

  • ✅ NFT floor prices
  • ✅ NFT metadata
  • ✅ NFT ownership
  • ✅ Collection stats

​
Transaction endpoints

  • ✅ Transaction receipts
  • ✅ Gas prices
  • ✅ Block data

​
Market data endpoints

  • ✅ Token prices
  • ✅ Trading volume
  • ✅ Market cap
Data consensus is not available for JSON-RPC endpoints or provider-specific features.

​
Performance impact

Data consensus adds latency as it queries multiple providers:
Providers queriedAdded latencyUse case
2 providers~50-100msLow-latency needs
3 providers~100-200msStandard verification
4 providers~150-300msMaximum accuracy
Optimization tips:
  • Enable only for critical endpoints
  • Use lower provider counts for time-sensitive operations
  • Cache consensus results when appropriate
  • Disable for non-critical data

​
Key benefits

Enhanced accuracy

Cross-verify data across multiple sources for guaranteed accuracy.

Error detection

Automatically detect and filter provider errors and anomalies.

Reduced risk

Minimize impact of incorrect data on critical operations.

Confidence

Make decisions based on verified, consensus-based data.

​
When to use data consensus

​
✅ Use data consensus for:

  • Token prices - Critical for trading, swaps, portfolio valuation
  • Token balances - Important for transaction validation
  • NFT floor prices - Essential for marketplace accuracy
  • Gas prices - Affects transaction cost calculations
  • Financial calculations - Any data affecting money

​
Next steps

Auto-retry

Learn how auto-retry works with data consensus.

Backup providers

Configure provider fallback lists for consensus queries.

Routing optimization

Optimize provider selection for consensus queries.

Dashboard

Configure consensus settings and monitor metrics.

​
Common pitfalls

Using for all endpoints - Data consensus adds latency and cost. Only enable for critical data.
Too strict thresholds - Overly strict outlier detection may flag valid variations. Use moderate settings.
Ignoring outlier patterns - Frequent outliers from one provider indicate reliability issues. Investigate and adjust.
Not accounting for latency - Consensus adds 100-300ms. Factor this into timeout and UX design.

Ready to get started with Uniblock?

Create your free account and start building with unified blockchain infrastructure across 100+ chains.

View API reference

Explore all available endpoints and interactive playgrounds

Join our community

Get help from our team and connect with other developers