Quickstart Guide

Get your first API response in 5 minutes ⏱ 5 min

1
Get your API Key

Sign up at /subscribe with your email. You'll receive your API key instantly.

Your key: fo_live_xxxxxxxxxxxxxxxx
2
Make your first request

Test the API with a simple health check:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://feedoracle.io/api/v1/feeds/health
3
Check the response

You should see a JSON response like this:

{
  "status": "healthy",
  "meta": {
    "feed_name": "rwa_health",
    "schema_version": "1.0.0",
    "request_id": "req_abc123"
  }
}
4
Get real data

Fetch carbon intensity for all blockchain networks:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://feedoracle.io/api/v1/carbon/chains
5
Explore more endpoints

Try these popular endpoints:

# World Bank GDP data
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://feedoracle.io/worldbank/gdp

# UK Grid carbon intensity (real-time)
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://feedoracle.io/grid/uk/now

# Macro economic health
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://feedoracle.io/macro/api/v1/macro/health

You're all set! 🎉

Need Help?

← Back to Documentation