The Graph

Access indexed blockchain data through The Graph subgraphs. Query ENS registrations, Uniswap pools, Aave markets, and Lido staking stats.

Full Tutorial

See The Graph Queries Tutorial for comprehensive examples.

Available Subgraphs

Subgraph	Description	Network
ens	ENS domain registrations & transfers	Hosted Service
uniswapV3	Uniswap V3 pools, swaps, liquidity	Decentralized
aaveV3	Aave V3 lending markets	Decentralized
lido	Lido staking submissions	Hosted Service
compound	Compound V2 markets	Hosted Service

---

ENS Subgraph

Endpoint	Description	Price
GET /api/graph/ens/registrations	Recent ENS registrations	$0.01
GET /api/graph/ens/domain/{name}	Domain details	$0.01
GET /api/graph/ens/transfers	Recent domain transfers	$0.01
GET /api/graph/ens/owner/{address}	Domains by owner	$0.01

Example: Recent Registrations

curl "https://api.web3identity.com/api/graph/ens/registrations?limit=10"

{
  "registrations": [
    {
      "name": "coolname.eth",
      "registrant": "0x1234...",
      "registrationDate": "2026-02-09T08:00:00.000Z",
      "expiryDate": "2027-02-09T08:00:00.000Z"
    }
  ],
  "source": "thegraph/ens"
}

---

Uniswap V3 Subgraph

Endpoint	Description	Price
GET /api/graph/uniswap/pools	Top pools by TVL	$0.01
GET /api/graph/uniswap/pool/{address}	Pool details	$0.01
GET /api/graph/uniswap/swaps	Recent swaps	$0.01
GET /api/graph/uniswap/stats	Protocol-wide stats	$0.01

Example: Top Pools

curl "https://api.web3identity.com/api/graph/uniswap/pools?limit=5"

{
  "pools": [
    {
      "address": "0x8ad599c3...",
      "pair": "USDC/ETH",
      "feeTier": "0.3%",
      "tvlUsd": 456789012.34,
      "volumeUsd": 12345678901.23
    }
  ],
  "source": "thegraph/uniswap-v3"
}

---

Aave V3 Subgraph

Endpoint	Description	Price
GET /api/graph/aave/markets	Lending markets with APY	$0.01

Example: Markets

curl "https://api.web3identity.com/api/graph/aave/markets?limit=10"

{
  "markets": [
    {
      "symbol": "WETH",
      "supplyApy": 0.0234,
      "borrowApy": 0.0456,
      "utilization": 0.20
    }
  ],
  "source": "thegraph/aave-v3"
}

---

Lido Subgraph

Endpoint	Description	Price
GET /api/graph/lido/stats	Staking stats	$0.01

---

Custom Queries

Endpoint	Description	Price
POST /api/graph/query/{subgraph}	Run custom GraphQL query	$0.02
GET /api/graph/subgraphs	List available subgraphs	Free

Example: Custom Query

curl -X POST https://api.web3identity.com/api/graph/query/ens \
  -H "Content-Type: application/json" \
  -d '{"query": "{ domains(first: 5) { name owner { id } } }"}'

---

Query Parameters

Param	Type	Default	Max
limit	number	25	100

---

Data Freshness

• Decentralized network (Uniswap, Aave): ~1-5 minutes lag
• Hosted service (ENS, Lido): ~10-30 seconds lag

For real-time data, use RPC endpoints directly.

---

Related

• The Graph Tutorial — Full guide
• TVL Endpoints — DeFi TVL data
• ENS Resolution — Direct ENS lookups