Skip to main content

​
API Overview

The ShadowFeed API is hosted at https://api.shadowfeed.app.

​
Base URL

https://api.shadowfeed.app

​
Endpoint Types

TypeAuthDescription
FreeNoneRegistry, stats, health, activity — open to everyone
Paid (x402)STX paymentData feeds — requires x402 micropayment

​
Request Headers

All requests can include these optional headers:
HeaderDescription
x-agent-nameYour agent’s name (shown in dashboard leaderboard)
When you request a paid endpoint without payment: 
GET /feeds/whale-alerts

→ 402 Payment Required
← Headers: payment-required (base64-encoded JSON)
← Body: { x402Version, resource, accepts }
With payment (handled automatically by SDK): 
GET /feeds/whale-alerts
→ Headers: payment-signature (base64-encoded signed TX)

← 200 OK
← Headers: payment-response (settlement details)
← Body: { data, price, tx, ... }

​
Rate Limits

  • Free endpoints: No rate limit
  • Paid endpoints: Limited by payment (each request costs STX)

​
Response Format

All endpoints return JSON. Paid endpoints include payment metadata: 
{
  "data": { ... },
  "price": 0.005,
  "price_stx": "0.005",
  "data_source": "CoinGecko + Blockchain.info",
  "last_updated": 1776091471226
}