API Documentation
Complete documentation for the Pi Network Price Oracle and data endpoints. Access real-time Pi prices, blockchain data, and more.
The oracle is hosted on Zyraview. Purchase a key for 100 Pi on the Oracle API page, then send X-API-Key on every request.
https://zyraview-server.onrender.com/api/oracle/v1/priceAggregated PI/USD price (weighted average, cached).
Example Request:
curl -H "X-API-Key: zyra_..." "https://zyraview-server.onrender.com/api/oracle/v1/price"/v1/sourcesStatus of each upstream price source.
/v1/healthOracle process health and uptime.
/data/pi-pricePi price in piscan-style shape.
/data/mainnet-supplyCirculating / locked / total supply snapshot.
/horizon/*Proxy to Pi mainnet Horizon (path forwarded).
Legacy public oracle (reference)
Older deployments may still use this base URL without Zyraview API keys.
https://oracle-three-xi.vercel.appMultiple Data Sources
CoinGecko, Bitget, OKX exchanges
Cost Effective
Free API tiers with intelligent caching
Real-time Updates
30-second cache with efficient polling
Fault Tolerant
Continues operating if sources fail
Pi Network Integration
Complete piscan.io API compatibility
Horizon Proxy
Direct Pi Network blockchain access
/api/v1/priceGet the current aggregated Pi Network price from multiple sources
Example Request:
curl https://oracle-three-xi.vercel.app/api/v1/priceResponse:
{
"symbol": "PI",
"price_usd": 1.23,
"timestamp": "2025-01-14T12:00:00.000Z",
"sources_used": 3,
"total_sources": 3,
"aggregation_method": "weighted_average",
"source_prices": {
"coingecko": { "price": 1.22, "weight": 1.5, "timestamp": "2025-01-14T12:00:00.000Z" },
"bitget": { "price": 1.23, "weight": 2.0, "timestamp": "2025-01-14T12:00:00.000Z" },
"okx": { "price": 1.24, "weight": 1.5, "timestamp": "2025-01-14T12:00:00.000Z" }
},
"confidence_score": 0.95,
"cache_hit": false
}/api/v1/healthCheck the health status of the oracle service
Example Request:
curl https://oracle-three-xi.vercel.app/api/v1/healthResponse:
{
"status": "healthy",
"uptime": 3600,
"timestamp": "2025-01-14T12:00:00.000Z"
}/api/v1/sourcesGet the status and reliability metrics of all data sources
Example Request:
curl https://oracle-three-xi.vercel.app/api/v1/sourcesResponse:
{
"sources": [
{
"name": "coingecko",
"status": "active",
"last_success": "2025-01-14T12:00:00.000Z",
"last_error": null,
"success_rate": 0.99,
"avg_response_time_ms": 250
}
]
}Cost Analysis
| Source | Free Tier Limit | Cost After Free | Auth Required |
|---|---|---|---|
| CoinGecko | 50 calls/min | $0 | No |
| Bitget | Rate limited | $0 | No |
| OKX | Rate limited | $0 | No |
| Horizon API | Rate limited | $0 | No |
Total Monthly Cost with 30-second caching: $0
With caching, you get ~86,400 requests/month within all free tiers