Azuro GraphQL APIs

Comprehensive blockchain data indexing infrastructure built on The Graph protocol for querying on-chain data from Azuro's prediction market smart contracts. The APIs transform raw blockchain events into structured, queryable GraphQL endpoints, enabling efficient data retrieval without direct blockchain node access.

Core Indexing Infrastructure

The Graph Subgraphs: Multi-chain deployment of subgraphs that continuously index blockchain events from Azuro smart contracts across Gnosis Chain, Polygon, Chiliz, and Arbitrum. Each subgraph maintains real-time synchronization with blockchain state, processing contract events into structured entities.

Indexed Entities (20+ entity types):

• Smart Contracts: LiquidityPoolContract, CoreContract, AzuroBetContract, ExpressPrematchRelation, FreebetContract
• Sports Hierarchy: SportHub, Sport, League, Country for organizing event data
• Games & Markets: Game, Participant, Condition, Outcome entities with comprehensive filtering
• Betting Data: Bet, LiveBet, Selection, LiveSelection, Bettor profiles with lifecycle tracking
• Live Markets: LiveCondition, LiveOutcome for real-time betting data
• Events: Blockchain event logs for bet lifecycle tracking and audit trails

Developer Integration

SDK Integration: The Azuro SDK (v6) provides React hooks and providers that abstract GraphQL query complexity. Developers access indexed data through type-safe hooks like useSports, useGames, useConditions, useActiveMarkets, useBets, and useBetsSummary without writing raw GraphQL queries.

Data Access Patterns:

• TypeScript-first with full type definitions for autocomplete
• Built-in caching and request optimization
• Real-time subscriptions for live data updates
• Batch query support to minimize API calls
• Error handling with detailed field-level validation

Query Capabilities

Advanced Filtering: Complex WHERE clauses supporting AND/OR logic across all entity fields

Relationship Traversal: Nested queries spanning entity relationships (e.g., Game → League → Sport → SportHub)

Pagination: Cursor-based and offset pagination for large datasets with configurable page sizes

Sorting: Multi-field ORDER BY with ascending/descending support

Historical Queries: Time-travel queries for accessing historical blockchain state

Aggregation: Count, sum, and statistical queries across indexed data

Performance Features

Multi-Chain Coverage: Separate subgraph deployments per blockchain ensure isolated performance and reliability

Real-Time Streaming: WebSocket subscriptions for instant updates on live betting markets and odds changes

Query Optimization: Field selection minimizes data transfer, automatic query batching reduces request count

Caching Recommendations: Built-in cache control headers for frequently accessed data patterns

API Endpoints: Dedicated GraphQL Playground environments for interactive query testing and schema exploration

Technical Architecture

The indexing layer eliminates the need for applications to run blockchain nodes, parse event logs, or manage complex state synchronization. All blockchain data is pre-processed, validated, and structured into GraphQL schemas that support efficient querying at scale.

Legacy Support: Historical archives maintain v1/v2 protocol data for backward compatibility

Schema Evolution: Versioned API schemas allow backwards-compatible upgrades as protocol evolves

Monitoring: Built-in health checks and subgraph synchronization status endpoints