Skip to main content

​
Free Endpoints

These endpoints require no payment or authentication.

​
GET /health

Check API status. 
curl https://api.shadowfeed.app/health

{
  "status": "operational",
  "version": "2.0.0",
  "provider": "SP1DV3T4ST2A89ZZ07M73B2N4AR5XFMDCNPGKK6CS",
  "network": "stacks:1",
  "feeds_available": 16,
  "payment_protocol": "x402-stacks"
}

​
GET /registry/feeds

List all available data feeds with pricing and stats. 
curl https://api.shadowfeed.app/registry/feeds

{
  "protocol": "shadowfeed",
  "version": "1.0.0",
  "description": "Decentralized data marketplace for AI agents via x402 micropayments",
  "provider": "SP1DV3T4ST2A89ZZ07M73B2N4AR5XFMDCNPGKK6CS",
  "payment_protocol": "x402-stacks",
  "settlement": "STX on Stacks (Bitcoin L2)",
  "feeds": [
    {
      "id": "whale-alerts",
      "endpoint": "/feeds/whale-alerts",
      "price_stx": 0.005,
      "price_display": "0.005 STX",
      "description": "Real-time whale movements...",
      "category": "on-chain",
      "update_frequency": "real-time",
      "stats": {
        "total_queries": 142,
        "avg_response_ms": 450,
        "uptime_percent": 99.8
      }
    }
  ]
}

​
GET /stats

Provider statistics and reputation. 
curl https://api.shadowfeed.app/stats

{
  "total_queries_served": 342,
  "reputation_score": 95,
  "tier": "verified",
  "uptime_percent": 99.8,
  "feed_breakdown": [
    {
      "feed_id": "whale-alerts",
      "queries": 89,
      "avg_response_ms": 420,
      "error_rate": 0
    }
  ]
}

​
GET /activity

Recent marketplace activity. 
curl https://api.shadowfeed.app/activity?limit=10

{
  "total_revenue_stx": 1.234,
  "unique_agents": 5,
  "activity": [
    {
      "id": 1,
      "feed": "whale-alerts",
      "agent_name": "Hyre Agent",
      "agent_short": "SP2PBB...J0F7SG",
      "price_stx": 0.005,
      "response_ms": 380,
      "is_onchain": true,
      "tx_hash": "0xabc123...",
      "time_ago": "2m"
    }
  ]
}

​
GET /leaderboard

Top agents by query count and spending. 
curl https://api.shadowfeed.app/leaderboard

{
  "agents": [
    {
      "rank": 1,
      "agent_name": "Hyre Agent",
      "address_short": "SP2PBB...J0F7SG",
      "total_queries": 45,
      "total_spent_stx": 0.892
    }
  ]
}