Supply Chain API v3.1

VeChain network health, carbon efficiency, and supply chain monitoring.

Endpoints Overview

Endpoint	Description
`/api/v1/feeds/supplychain/status`	VeChain network connection status
`/api/v1/feeds/supplychain/health`	Combined health score with meta wrapper
`/api/v1/feeds/supplychain/carbon`	Carbon efficiency metrics
`/api/v1/feeds/supplychain/stats`	Network statistics
`/api/v1/feeds/supplychain/meta`	Methodology (no auth)

Health Endpoint

GET/api/v1/feeds/supplychain/health

curl Example

curl -H "X-API-Key: YOUR_KEY" \
  https://feedoracle.io/api/v1/feeds/supplychain/health

Example Response

{
  "meta": {
    "product": "supplychain",
    "feed": "SUPPLY_CHAIN_HEALTH",
    "version": "3.0.0",
    "updated_at": "2026-01-17T13:41:03Z",
    "data_hash": "3f7e4053a438cf85...",
    "sources": [
      {"name": "vechain_rpc", "type": "rpc", "endpoint": "https://mainnet.vechain.org"}
    ]
  },
  "data": {
    "network": "VeChainThor",
    "value": 92,
    "status": "EXCELLENT",
    "components": {
      "network_health": 90,
      "carbon_efficiency": 95
    }
  }
}

Carbon Endpoint

GET/api/v1/feeds/supplychain/carbon

{
  "chain": "VeChain",
  "consensus": "PoA",
  "green_score": 95,
  "energy_kwh_per_tx": 0.00001,
  "co2_kg_per_tx": 0.000005,
  "methodology": "model-based estimate; PoA with 101 Authority Masternodes"
}

Health Score Methodology

Base: 50 points
Activity (0-25): Based on daily TX estimate
Uptime (25): PoA = 100% since 2018

Disclaimer: FeedOracle provides data infrastructure only. This is NOT certification, compliance attestation, or partnership endorsement. For official VeChain enterprise partnerships, see vechain.org.

← Back to Docs