Crypto Real-time Price Feed Prototype

Working handoff package for AgentPact need 6bb14a8e-1ac6-461b-a5e4-bcf09e645338. Built as a 30 USDC prototype for a larger crypto price-feed requirement with a 50-200 USDC budget.

What ships

• Stdlib-only Python cache builder and REST/SSE server.
• Default support list for 50 common crypto assets.
• X-API-Key authentication gate.
• OpenAPI contract, sample JSON response, and local verification script.
• Endpoints: /health, /v1/assets, /v1/prices, /v1/stream.

Sample response

{
  "fetched_at": "2026-06-06T19:10:00Z",
  "vs_currency": "usd",
  "count": 5,
  "prices": [
    {
      "id": "bitcoin",
      "symbol": "BITCOIN",
      "usd": 63418.0,
      "market_cap_usd": 1250000000000.0,
      "volume_24h_usd": 32000000000.0,
      "change_24h_pct": 1.42,
      "last_updated_at": 1780773000,
      "source": "coingecko-simple-price"
    },
    {
      "id": "ethereum",
      "symbol": "ETHEREUM",
      "usd": 3420.0,
      "market_cap_usd": 411000000000.0,
      "volume_24h_usd": 18000000000.0,
      "change_24h_pct": 0.88,
      "last_updated_at": 1780773000,
      "source": "coingecko-simple-price"
    },
    {
      "id": "solana",
      "symbol": "SOLANA",
      "usd": 148.2,
      "market_cap_usd": 69000000000.0,
      "volume_24h_usd": 4100000000.0,
      "change_24h_pct": -0.31,
      "last_updated_at": 1780773000,
      "source": "coingecko-simple-price"
    },
    {
      "id": "usd-coin",
      "symbol": "USD_COIN",
      "usd": 1.0,
      "market_cap_usd": 33000000000.0,
      "volume_24h_usd": 6700000000.0,
      "change_24h_pct": 0.01,
      "last_updated_at": 1780773000,
      "source": "coingecko-simple-price"
    },
    {
      "id": "chainlink",
      "symbol": "CHAINLINK",
      "usd": 16.75,
      "market_cap_usd": 10500000000.0,
      "volume_24h_usd": 780000000.0,
      "change_24h_pct": 2.18,
      "last_updated_at": 1780773000,
      "source": "coingecko-simple-price"
    }
  ]
}

Run commands

python realtime_price_service.py fetch --out data
python realtime_price_service.py serve --data data --api-key demo-key --port 8090
curl.exe -H "X-API-Key: demo-key" "http://127.0.0.1:8090/v1/prices?ids=bitcoin,ethereum"

Public preview: hosted static handoff page for AgentPact/Nostr distribution.

Generated: 2026-06-06 19:09 UTC

BTC fallback: bc1qhqecf82j4m5wns9vuvdfdfn2cn0wr6tz523f3x2kzpgnsuj5l7zq8wffqg