API Documentation

Blockchain sustainability data infrastructure for regulatory disclosure workflows

54+ Networks DAP Attestation Multi-Chain Anchoring MiCA Art. 66 Support

What FeedOracle Is

FeedOracle is an independent data provider for blockchain sustainability and risk indicators. We aggregate, structure, and deliver machine-readable data designed for disclosure and reporting workflows.

Core Function

  • Aggregates sustainability data for 54+ blockchain networks
  • Structures data for regulatory frameworks (MiCA Art. 66, CSRD/ESRS)
  • Provides cryptographic attestation via the DAP protocol
  • Documents methodology, sources, and data quality transparently

What FeedOracle Is NOT

Important: FeedOracle operates strictly as a data provider. The following activities are explicitly outside our scope.
Not a compliance advisorWe do not advise on regulatory obligations or interpret regulations for specific entities
Not a certifier or approverWe hold no regulatory authority and issue no certifications or approvals
Not a rating agencyWe do not produce ESG ratings or creditworthiness assessments
Not a legal advisorWe do not provide legal interpretation of MiCA, CSRD, or any regulation
Not an auditorWe do not audit or verify user disclosures to regulators

Responsibility Allocation

  • FeedOracle: Delivers data as documented, maintains stated methodologies, provides attestation
  • Data User: Validates suitability, ensures compliance, bears disclosure responsibility

What FeedOracle Is NOT

❌NOT a Compliance Advisor – We do not interpret regulations or provide legal advice
❌NOT a Rating Agency – We do not score, rate, or rank blockchain networks
❌NOT an Auditor – We do not verify, validate, or certify data accuracy
❌NOT a Certification Body – Our attestations prove delivery, not compliance
❌NOT a Decentralized Oracle – We are centralized infrastructure, not consensus-based

User Responsibility: All compliance decisions, data interpretation, and regulatory filings are the sole responsibility of the user. FeedOracle provides data infrastructure only.

Who Uses FeedOracle

FeedOracle APIs serve organizations requiring structured blockchain sustainability data for compliance, reporting, and operational workflows.

Crypto-Asset Service Providers (CASPs)

Integrate MiCA Art. 66 sustainability disclosures. Retrieve structured data on energy, emissions, and consensus for supported crypto-assets.

Exchanges & Trading Platforms

Populate sustainability transparency pages. Display per-network metrics with source attribution and update timestamps.

RegTech Platforms

Embed disclosure modules into compliance platforms. API-first design supports white-label and custom integrations.

Asset Managers & ESG Teams

Assess portfolio sustainability for ESG mandates. Third-party verified data supports due diligence requirements.

Auditors & Compliance Reviewers

Verify historical data snapshots using DAP attestation. Cryptographic proofs confirm data delivery independent of client records.

AI Agents & Autonomous Systems

Consume verifiable sustainability signals. DAP enables programmatic verification without human intervention.

Architecture

FeedOracle operates as a four-layer data infrastructure. For detailed documentation, see Architecture Overview.

┌─────────────────────────────────────────────────────────┐
│  Layer 4: ATTESTATION (DAP) - Cryptographic proofs      │
├─────────────────────────────────────────────────────────┤
│  Layer 3: DISCLOSURE APIs - MiCA, CSRD, ESG formats     │
├─────────────────────────────────────────────────────────┤
│  Layer 2: STRUCTURED INDICATORS - Normalized metrics    │
├─────────────────────────────────────────────────────────┤
│  Layer 1: RAW DATA - Third-party sources, on-chain      │
└─────────────────────────────────────────────────────────┘
Architecture DetailsFour-layer data infrastructure Use CasesIntegration examples

What FeedOracle Is NOT

❌NOT a Compliance Advisor – We do not interpret regulations or provide legal advice
❌NOT a Rating Agency – We do not score, rate, or rank blockchain networks
❌NOT an Auditor – We do not verify, validate, or certify data accuracy
❌NOT a Certification Body – Our attestations prove delivery, not compliance
❌NOT a Decentralized Oracle – We are centralized infrastructure, not consensus-based

User Responsibility: All compliance decisions, data interpretation, and regulatory filings are the sole responsibility of the user. FeedOracle provides data infrastructure only.

Authentication

Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY

Get your API key at /subscribe.

Base URL

https://feedoracle.io

API Availability by Tier

Carbon Monitor API

FeatureFreeDeveloper €49Professional €299Enterprise
Networks54545454 + custom
Third-party verified❌✅ 7✅ All✅ All
Historical data❌30 days12 monthsUnlimited
Requests100/day10K/mo100K/moUnlimited
DAP Attestation❌BasicFullFull + Export

MiCA Disclosure API (v3)

FeatureFreeDeveloperProfessionalEnterprise
Sustainability reportsSample✅✅✅
Temporal metadata❌✅✅✅
DAP attestation❌BasicFullFull
Compliance report❌❌✅✅ + custom
Audit export❌❌❌✅

RWA Health Monitor

FeatureFreeDeveloperProfessionalEnterprise
Asset coverage5AllAllAll
Health scores✅✅✅✅
Treasury data❌BasicFullFull
Historical❌❌90 daysUnlimited

Macro Risk API

FeatureFreeDeveloperProfessionalEnterprise
Indicators3AllAllAll
Update frequencyDailyHourlyReal-timeReal-time
Verified sources❌✅✅✅

Carbon Data

GET /api/v1/carbon/chains

Retrieve carbon and sustainability data for all 54+ blockchain networks.

{
  "count": 54,
  "timestamp": 1736770800,
  "chains": [{
    "symbol": "ETH",
    "chain": "Ethereum",
    "consensus": "Proof of Stake",
    "energy_twh_year": 0.0026,
    "co2_mt_year": 0.0013,
    "renewable_energy_percent": 52,
    "green_score": 85,
    "data_quality": "THIRD_PARTY_VERIFIED",
    "data_source": "CCRI"
  }]
}
GET /api/v1/carbon/summary

Aggregated statistics across all tracked networks.

Disclosure API v3 DAP

GET /api/v3/disclosure/networks

List all networks with disclosure support status and attestation.

GET /api/v3/disclosure/sustainability/{symbol}

Full sustainability disclosure report with DAP attestation. Structured for MiCA Art. 66 workflows.

{
  "feedoracle_disclosure_data": {
    "schema_version": "3.0",
    "temporal": {
      "timestamp": "2026-01-13T10:30:00.123Z",
      "timestamp_unix": 1736765400123
    },
    "network": {
      "name": "Ethereum",
      "symbol": "ETH",
      "consensus": "Proof of Stake"
    },
    "sustainability_indicators": {
      "energy": {"annual_kwh": 2600000, "per_tx_kwh": 0.006476},
      "emissions": {"annual_tco2e": 1300, "intensity_gco2_kwh": 335},
      "renewable": {"percentage": 52}
    },
    "provenance": {
      "level": "third_party_sourced",
      "source": "CCRI"
    }
  },
  "attestation": {
    "attestation_id": "dap_2026_q1_abc12345",
    "data_hash": "7f83b1657ff1fc53b92dc18148a1d65d...",
    "verify_url": "https://feedoracle.io/verify/dap_2026_q1_abc12345"
  },
  "legal": {
    "disclaimer": "Data provided for informational purposes only.",
    "responsibility": "User responsible for regulatory compliance.",
    "terms": "https://feedoracle.io/terms"
  }
}

DAP - Disclosure Attestation Protocol NEW

Cryptographic proof of what data was delivered, when it was delivered, and that it has not been altered. Every API response is hashed, aggregated into Merkle trees, and anchored on-chain.

What DAP Proves: DAP provides evidence of data delivery. It does not certify, approve, or guarantee accuracy or regulatory compliance of the underlying data.

Multi-Chain Anchoring

Polygon0xeDdD...DDda
Base0x806b...4F8b
Arbitrum0x3225...32F7
Ethereum0x4b46...2a2f
GET /api/v2/attestation/status

DAP service status including on-chain connection info.

GET /verify/{attestation_id}

Public verification endpoint. Anyone can verify an attestation without authentication.

GET /api/v2/attestation/chains

Status of all anchoring chains with balances and contract addresses.

Enterprise Features ENTERPRISE

GET /api/v2/attestation/audit/export

Export attestations for audit purposes. Supports JSON and CSV formats.

ParameterTypeDescription
startstringStart date (YYYY-MM-DD)
endstringEnd date (YYYY-MM-DD)
formatstringjson (default) or csv
GET /api/v2/attestation/compliance/report/{symbol}

Generate compliance report for a specific network with DAP attestation.

Data Disclaimer

Important: This disclaimer applies to all FeedOracle data and must be understood by all data consumers.

FeedOracle provides data for informational purposes to support regulatory disclosure obligations. This data does not constitute legal, financial, tax, or compliance advice.

Data Quality Levels

  • Third-Party Sourced: Data obtained from external verified sources (Cambridge CBECI, CCRI, DNV). Source attribution provided.
  • Calculated: Data computed by FeedOracle using documented methodologies. Methodology available upon request.

User Responsibility

Data users are solely responsible for:

  1. Validating data suitability for their specific use case
  2. Ensuring compliance with applicable regulations
  3. Accuracy of disclosures to competent authorities
  4. Independent verification where required by their regulatory framework

Standard API Response Footer

{
  "legal": {
    "disclaimer": "Data provided for informational purposes only.",
    "responsibility": "User remains solely responsible for regulatory compliance.",
    "data_quality": "THIRD_PARTY_SOURCED | CALCULATED",
    "source": "Source attribution",
    "timestamp": "ISO 8601 timestamp",
    "terms": "https://feedoracle.io/terms"
  }
}

Language Guidelines

FeedOracle maintains strict language standards for legal and regulatory safety.

❌ Forbidden Phrases

MiCA compliantImplies regulatory approval we cannot grant
MiCA certifiedOnly NCAs can certify compliance
Guaranteed complianceNo data provider can guarantee this
Official MiCA reportSuggests regulatory authority status
Approved byImplies endorsement we do not have
AuditedReserved for formal external audits

✅ Allowed Alternatives

Supports MiCA Art. 66 disclosureDescribes function accurately
Structured for regulatory reportingNeutral, factual
Aligned with CSRD requirementsDescribes data structure
Third-party sourced from [Name]Clear attribution
Calculated using documented methodologyTransparent process

Use Cases

For detailed integration examples, see the Use Cases documentation.

MiCA Art. 66 DisclosureCASP sustainability reporting CSRD/ESRS ReportingESG compliance data Exchange TransparencyPublic sustainability pages AI Agent ConsumptionVerifiable data feeds

🌍 RWA Context Layer

Institutional macroeconomic data for RWA validation

GET /worldbank/gdp Top economies by GDP
GET /worldbank/country/{iso3} All indicators for country (GDP, growth, inflation)
GET /grid/uk/now Real-time UK grid carbon intensity
GET /grid/uk/generation Current UK energy generation mix
GET /grid/country/{iso2} Historical grid carbon by country (EMBER)
GET /energy/country/{iso3} Energy data: renewable share, carbon intensity (OWID)
GET /energy/renewable/{iso3} 5-year renewable energy trend
GET /trade/country/{iso3} Trade flows: imports, exports, balance (UN Comtrade)
GET /macro/api/v1/macro/health US Economic Health Index (FRED)
GET /macro/api/v1/macro/risk Economic risk assessment

🎫 NFT & Gas Monitor

On-chain attestations with gas optimization

GET /api/nft/gas Current Polygon gas price + mint cost estimate
GET /api/nft/queue View pending attestation queue
GET /api/nft/worker/status Background worker status + log
POST /api/nft/dap/attest Create attestation (auto-queued if gas high)
GET /api/nft/contracts Polygon mainnet contract addresses