Developers — FeedOracle | API Documentation & Integration Guide

Quick Start

Get your first response in under 5 minutes. Free tier: 100 requests/day, no credit card.

import requests

API_KEY = "your_api_key"
BASE    = "https://api.feedoracle.io"
headers = {"X-API-Key": API_KEY}

# RWA Risk Score for BlackRock BUIDL
r = requests.get(f"{BASE}/v1/rwa/risk/blackrock-buidl", headers=headers)
data = r.json()
print(f"Risk Score: {data[risk_score]}/100")
print(f"Evidence: {data[evidence][content_hash]}")

# ECB Interest Rates (public, no auth)
ecb = requests.get(f"{BASE}/api/v1/macro/ecb/rates").json()
print(f"ECB Deposit: {ecb[policy_rates][deposit_rate][value]}%")

# ESMA Register: German CASPs
casps = requests.get(f"{BASE}/api/v1/esma/casps?country=DE").json()
print(f"DE CASPs: {casps[count]}")

const API_KEY = "your_api_key";
const BASE = "https://api.feedoracle.io";

// RWA Risk Score
const res = await fetch(\`\${BASE}/v1/rwa/risk/blackrock-buidl\`, {
  headers: { "X-API-Key": API_KEY }
});
const data = await res.json();
console.log(\`Risk: \${data.risk_score}/100\`);

// ECB Rates (public)
const ecb = await (await fetch(\`\${BASE}/api/v1/macro/ecb/fx\`)).json();
console.log(\`EUR/USD: \${ecb.rates.eur_usd.value}\`);

# RWA Risk (requires API key)
curl -H "X-API-Key: YOUR_KEY" \
  https://api.feedoracle.io/v1/rwa/risk/blackrock-buidl

# ECB Rates (public)
curl https://api.feedoracle.io/api/v1/macro/ecb/rates

# MiCA-relevant protocols
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.feedoracle.io/v1/rwa/risk?mica=true"

# ESMA non-compliant entities
curl https://api.feedoracle.io/api/v1/esma/non-compliant

// Chainlink Functions Consumer
pragma solidity ^0.8.20;

import {FunctionsClient} from
  "@chainlink/contracts/.../FunctionsClient.sol";

contract FeedOracleConsumer is FunctionsClient {
    string constant SOURCE =
      "const r = await Functions.makeHttpRequest({"
      "  url: https://api.feedoracle.io
       /v1/rwa/risk/blackrock-buidl,"
      "  headers: {X-API-Key: args[0]}"
      "});"
      "return Functions.encodeUint256("
      "  r.data.risk_score);";
}

API Categories

Category	Key Endpoints	Auth	Update
RWA Risk Intelligence	`/v1/rwa/risk` · `/v1/rwa/risk/{slug}` · `/v1/rwa/compliance/{slug}`	API Key	5 min
MiCA Stablecoin	`/api/v1/feeds/stablecoin/{symbol}` · `/api/v3/stablecoin/mica`	API Key	5 min
ESMA Register	`/api/v1/esma/casps` · `/api/v1/esma/emt-issuers` · `/api/v1/esma/non-compliant`	Public	Weekly
ECB Macro	`/api/v1/macro/ecb/rates` · `/api/v1/macro/ecb/fx` · `/api/v1/macro/ecb/inflation`	Public	Daily
FRED Macro	`/api/v1/macro/fred` · `/api/v1/macro/fred/{series}`	Public	Daily
Carbon & ESG	`/api/v1/feeds/carbon/chains` · `/api/v1/climatiq/grid/{country}`	API Key	Hourly
EU Energy	`/api/v1/eu-energy/generation/{cc}` · `/api/v1/eu-ets/price`	Public	15 min
DORA	`/api/v1/dora/overview` · `/api/v1/dora/ict-risk` · `/api/v1/dora/resilience-testing`	Public	On-demand
CSRD / ESRS	`/api/v1/csrd/esrs-e1` · `/api/v1/csrd/chain-footprint/{sym}`	Public	Hourly
Evidence	`/.well-known/jwks.json` · `/.well-known/epm.schema.json`	Public	Static