{
  "x402Version": 2,
  "site": "tensorfeed.ai",
  "publisher": {
    "name": "TensorFeed.ai",
    "url": "https://tensorfeed.ai",
    "description": "Real-time AI news, model pricing, service status, and machine-payable premium intelligence for AI agents.",
    "agent_fair_trade": "TensorFeed.ai is agent fair-trade certified: open pricing, automatic no-charge on 5xx, breaker, schema fail, and stale data, Ed25519-signed receipts on every paid call, inference-only license. Built with Claude (Anthropic). Standard at /.well-known/agent-fair-trade.json.",
    "method_support": {
      "live": [{ "method": "exact", "network": "eip155:8453", "asset_symbol": "USDC", "note": "USDC on Base mainnet, verified via Base RPC" }],
      "evaluating": [{ "method": "stripe", "credential_type": "shared_payment_token", "spec": "https://link.com/agents", "note": "Stripe Link Shared Payment Tokens via x402 with method=stripe in www-authenticate. Under evaluation; not yet accepted." }]
    },
    "contact": "contact@tensorfeed.ai",
    "docs": "https://tensorfeed.ai/developers/agent-payments",
    "llmsTxt": "https://tensorfeed.ai/llms.txt",
    "operator": {
      "legalEntity": "Pizza Robot Studios LLC",
      "jurisdiction": "California, USA",
      "terms": "https://tensorfeed.ai/terms",
      "privacy": "https://tensorfeed.ai/privacy",
      "note": "Pizza Robot Studios LLC is the legal entity behind the payment wallet. Premium credits are non-refundable per Section 17.5 of the Terms of Service."
    },
    "validation": {
      "method": "TLS + multi-publication",
      "publishedAt": [
        "https://tensorfeed.ai/llms.txt",
        "https://tensorfeed.ai/api/payment/info",
        "https://github.com/RipperMercs/tensorfeed",
        "https://x.com/tensorfeed"
      ],
      "note": "Cross-check the wallet address across all four published locations before sending funds. If any disagree, do not send."
    }
  },
  "payment": {
    "wallet": "0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "assetSymbol": "USDC",
    "assetDecimals": 6,
    "network": "eip155:8453",
    "networkName": "Base mainnet",
    "creditsPerUsd": 50,
    "centsPerCredit": 2,
    "volumeDiscounts": [
      { "minUsd": 5, "creditsPerUsd": 55, "label": "10% off" },
      { "minUsd": 30, "creditsPerUsd": 65, "label": "25% off" },
      { "minUsd": 200, "creditsPerUsd": 80, "label": "40% off" }
    ],
    "welcomeBonus": {
      "credits": 50,
      "usdValue": "1.00",
      "trigger": "first successful USDC payment from a new sender wallet",
      "appliesTo": ["credits flow (/api/payment/confirm)", "x402 fallback"],
      "stackableWithVolumeDiscounts": true,
      "responseFields": ["welcome_bonus_credits", "is_first_payment"]
    },
    "flows": {
      "credits": {
        "description": "Recommended for repeat use. Buy a bearer token once, decrement credits per call.",
        "endpoints": {
          "info": "https://tensorfeed.ai/api/payment/info",
          "quote": "https://tensorfeed.ai/api/payment/buy-credits",
          "confirm": "https://tensorfeed.ai/api/payment/confirm",
          "balance": "https://tensorfeed.ai/api/payment/balance",
          "usage": "https://tensorfeed.ai/api/payment/usage"
        }
      },
      "x402": {
        "description": "One-shot fallback. Call any /api/premium/* endpoint without auth; the 402 response includes payment instructions. Retry with X-Payment-Tx header to receive data and a token.",
        "header": "X-Payment-Tx",
        "verification": "Worker reads the USDC Transfer event from eth_getTransactionReceipt on the Base mainnet RPC. Replay protection: every used tx hash is permanently recorded."
      }
    },
    "terms": {
      "noTraining": "Premium data is licensed for inference use only. Use of TensorFeed premium endpoint responses for training, fine-tuning, evaluation, or distillation of machine learning models is prohibited.",
      "refund": "All credit purchases are final and non-refundable per Section 17.5 of the Terms. Credits do not expire and remain redeemable across tensorfeed.ai and terminalfeed.io. Recommended pattern: buy small (for example, $1 USDC for 50 credits), calibrate, top up as needed.",
      "sla": "No SLA in MVP phase. Credits do not expire.",
      "sanctions": "Premium API access is unavailable to persons or entities subject to OFAC, EU, UK, or UN sanctions, and to residents of comprehensively sanctioned jurisdictions (Cuba, Iran, North Korea, Syria, Crimea, Donetsk, Luhansk). Inbound credit-purchase transactions are screened against the Chainalysis public sanctions API. See https://tensorfeed.ai/terms#premium Section 17.9.",
      "acceptableUse": "No reselling of bearer tokens or proxy APIs that materially reproduce the Premium API surface. No use of premium responses to train or evaluate competing models. See Section 17.12.",
      "governingLaw": "California law. Exclusive venue: Los Angeles County, California. See Section 15 Governing Law and Venue."
    }
  },
  "items": [
    {
      "resource": "https://tensorfeed.ai/api/premium/routing",
      "type": "http",
      "method": "GET",
      "x402Version": 2,
      "accepts": [
        {
          "scheme": "exact",
          "network": "eip155:8453",
          "amount": "20000",
          "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
          "payTo": "0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1",
          "maxTimeoutSeconds": 60
        }
      ],
      "lastUpdated": "2026-04-27T00:00:00Z",
      "metadata": {
        "name": "Premium routing recommendations",
        "description": "Top-N ranked AI model recommendations for a task with full composite-score breakdown across quality, availability, cost, and latency. Synthesizes live pricing, benchmarks, and provider status.",
        "tier": 2,
        "credits": 1,
        "category": "ai-model-routing",
        "input": {
          "task": "code|reasoning|creative|general",
          "budget": 5.0,
          "min_quality": 0.7,
          "top_n": 3
        },
        "inputSchema": {
          "type": "object",
          "properties": {
            "task": { "type": "string", "enum": ["code", "reasoning", "creative", "general"], "description": "Task family the model needs to be good at" },
            "budget": { "type": "number", "description": "Max blended USD per 1M tokens" },
            "min_quality": { "type": "number", "minimum": 0, "maximum": 1 },
            "top_n": { "type": "integer", "minimum": 1, "maximum": 10 }
          }
        },
        "output": {
          "example": {
            "task": "code",
            "recommendations": [
              {
                "rank": 1,
                "model": { "name": "Claude Opus 4.7", "provider": "anthropic" },
                "pricing": { "input": 15, "output": 75, "currency": "USD", "unit": "per 1M tokens" },
                "status": "operational",
                "composite_score": 0.87,
                "components": { "quality": 0.94, "availability": 1.0, "cost": 0.65, "latency": 0.5 }
              }
            ],
            "billing": { "credits_charged": 1, "credits_remaining": 49 }
          }
        }
      }
    },
    {
      "resource": "https://tensorfeed.ai/api/premium/history/pricing/series",
      "type": "http",
      "method": "GET",
      "x402Version": 2,
      "accepts": [
        { "scheme": "exact", "network": "eip155:8453", "amount": "20000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1", "maxTimeoutSeconds": 60 }
      ],
      "lastUpdated": "2026-04-27T00:00:00Z",
      "metadata": {
        "name": "Pricing series",
        "description": "Daily input/output/blended price points for one model with min/max/delta summary. Default 30-day window, max 90 days.",
        "tier": 1,
        "credits": 1,
        "category": "ai-pricing-history"
      }
    },
    {
      "resource": "https://tensorfeed.ai/api/premium/history/benchmarks/series",
      "type": "http",
      "method": "GET",
      "x402Version": 2,
      "accepts": [
        { "scheme": "exact", "network": "eip155:8453", "amount": "20000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1", "maxTimeoutSeconds": 60 }
      ],
      "lastUpdated": "2026-04-27T00:00:00Z",
      "metadata": {
        "name": "Benchmark score series",
        "description": "Score evolution for a single benchmark on one model with delta in percentage points. Supported keys: swe_bench, mmlu_pro, gpqa_diamond, math, human_eval.",
        "tier": 1,
        "credits": 1,
        "category": "ai-benchmark-history"
      }
    },
    {
      "resource": "https://tensorfeed.ai/api/premium/history/status/uptime",
      "type": "http",
      "method": "GET",
      "x402Version": 2,
      "accepts": [
        { "scheme": "exact", "network": "eip155:8453", "amount": "20000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1", "maxTimeoutSeconds": 60 }
      ],
      "lastUpdated": "2026-04-27T00:00:00Z",
      "metadata": {
        "name": "Uptime rollup",
        "description": "Daily uptime rollup for one provider with operational, degraded, and down day counts. Uptime % treats degraded as half-credit. Missing-data days excluded from denominator.",
        "tier": 1,
        "credits": 1,
        "category": "ai-status-history"
      }
    },
    {
      "resource": "https://tensorfeed.ai/api/premium/agents/directory",
      "type": "http",
      "method": "GET",
      "x402Version": 2,
      "accepts": [
        { "scheme": "exact", "network": "eip155:8453", "amount": "20000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1", "maxTimeoutSeconds": 60 }
      ],
      "lastUpdated": "2026-04-27T00:00:00Z",
      "metadata": {
        "name": "Enriched agents directory",
        "description": "Static AI agents catalog joined with live status, recent news count and top 3 articles, agent traffic, flagship pricing, and a derived 0-100 trending_score. Server-side filter and sort.",
        "tier": 1,
        "credits": 1,
        "category": "ai-agents-directory"
      }
    },
    {
      "resource": "https://tensorfeed.ai/api/premium/news/search",
      "type": "http",
      "method": "GET",
      "x402Version": 2,
      "accepts": [
        { "scheme": "exact", "network": "eip155:8453", "amount": "20000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1", "maxTimeoutSeconds": 60 }
      ],
      "lastUpdated": "2026-04-27T00:00:00Z",
      "metadata": {
        "name": "News search",
        "description": "Full-text search over the AI news corpus with relevance scoring (term hits weighted 3 in title, 1 in snippet, plus recency boost) and date/provider/category filters.",
        "tier": 1,
        "credits": 1,
        "category": "ai-news-search"
      }
    },
    {
      "resource": "https://tensorfeed.ai/api/premium/whats-new",
      "type": "http",
      "method": "GET",
      "x402Version": 2,
      "accepts": [
        { "scheme": "exact", "network": "eip155:8453", "amount": "20000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1", "maxTimeoutSeconds": 60 }
      ],
      "lastUpdated": "2026-04-27T00:00:00Z",
      "metadata": {
        "name": "What's new",
        "description": "Agent morning brief: pricing changes, new/removed models, status incidents, and top news headlines from the last 1-7 days. The endpoint to call when an agent boots up.",
        "tier": 1,
        "credits": 1,
        "category": "ai-agent-brief"
      }
    },
    {
      "resource": "https://tensorfeed.ai/api/premium/mcp/registry/series",
      "type": "http",
      "method": "GET",
      "x402Version": 2,
      "accepts": [
        { "scheme": "exact", "network": "eip155:8453", "amount": "20000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1", "maxTimeoutSeconds": 60 }
      ],
      "lastUpdated": "2026-04-29T00:00:00Z",
      "metadata": {
        "name": "MCP registry series",
        "description": "Multi-day time series of the official Model Context Protocol server registry: total server count, active/deprecated breakdown, daily added and removed counts. 90-day max range. Compounds daily; backfill is impossible.",
        "tier": 1,
        "credits": 1,
        "category": "mcp-ecosystem-telemetry"
      }
    },
    {
      "resource": "https://tensorfeed.ai/api/premium/probe/series",
      "type": "http",
      "method": "GET",
      "x402Version": 2,
      "accepts": [
        { "scheme": "exact", "network": "eip155:8453", "amount": "20000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1", "maxTimeoutSeconds": 60 }
      ],
      "lastUpdated": "2026-04-29T00:00:00Z",
      "metadata": {
        "name": "LLM probe series",
        "description": "Per-day SLA series for one LLM provider, measured by TensorFeed itself: count, success rate, ttfb p50/p95/p99, total p50/p95/p99, incident-hour count. 90-day max range. Unique because we measure (vs. self-report). Pairs with /api/premium/routing.",
        "tier": 1,
        "credits": 1,
        "category": "llm-sla-measurement"
      }
    },
    {
      "resource": "https://tensorfeed.ai/api/premium/gpu/pricing/series",
      "type": "http",
      "method": "GET",
      "x402Version": 2,
      "accepts": [
        { "scheme": "exact", "network": "eip155:8453", "amount": "20000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1", "maxTimeoutSeconds": 60 }
      ],
      "lastUpdated": "2026-04-29T00:00:00Z",
      "metadata": {
        "name": "GPU pricing series",
        "description": "Daily price series for one canonical GPU (H200, H100, A100-80GB, RTX-4090, MI300X, etc) across all tracked marketplace providers: cheapest on-demand and spot per day, provider count, total offers, plus pct change start-to-end. 90-day max range, default 30 days back. Cannot be backfilled.",
        "tier": 1,
        "credits": 1,
        "category": "gpu-rental-pricing"
      }
    },
    {
      "resource": "https://tensorfeed.ai/api/premium/compare/models",
      "type": "http",
      "method": "GET",
      "x402Version": 2,
      "accepts": [
        { "scheme": "exact", "network": "eip155:8453", "amount": "20000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1", "maxTimeoutSeconds": 60 }
      ],
      "lastUpdated": "2026-04-27T00:00:00Z",
      "metadata": {
        "name": "Compare models",
        "description": "Side-by-side comparison of 2-5 AI models with pricing, benchmarks normalized to union-of-keys, status, and rankings (cheapest blended, most context, per-benchmark leaderboard).",
        "tier": 1,
        "credits": 1,
        "category": "ai-model-comparison"
      }
    },
    {
      "resource": "https://tensorfeed.ai/api/premium/providers/{name}",
      "type": "http",
      "method": "GET",
      "x402Version": 2,
      "accepts": [
        { "scheme": "exact", "network": "eip155:8453", "amount": "20000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1", "maxTimeoutSeconds": 60 }
      ],
      "lastUpdated": "2026-04-27T00:00:00Z",
      "metadata": {
        "name": "Provider deep-dive",
        "description": "Everything about one AI provider in one paid call: live status, all models with pricing + tier + benchmark scores joined, recent news, agent traffic. Aggregation over 4 free endpoints.",
        "tier": 1,
        "credits": 1,
        "category": "ai-provider-deepdive"
      }
    },
    {
      "resource": "https://tensorfeed.ai/api/premium/cost/projection",
      "type": "http",
      "method": "GET",
      "x402Version": 2,
      "accepts": [
        { "scheme": "exact", "network": "eip155:8453", "amount": "20000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1", "maxTimeoutSeconds": 60 }
      ],
      "lastUpdated": "2026-04-27T00:00:00Z",
      "metadata": {
        "name": "Cost projection",
        "description": "Project the cost of a token-usage workload across 1-10 AI models. Returns daily/weekly/monthly/yearly totals per model plus a ranking by cheapest monthly.",
        "tier": 1,
        "credits": 1,
        "category": "ai-cost-projection"
      }
    },
    {
      "resource": "https://tensorfeed.ai/api/premium/watches",
      "type": "http",
      "method": "POST",
      "x402Version": 2,
      "accepts": [
        { "scheme": "exact", "network": "eip155:8453", "amount": "20000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1", "maxTimeoutSeconds": 60 }
      ],
      "lastUpdated": "2026-04-27T00:00:00Z",
      "metadata": {
        "name": "Webhook watches",
        "description": "Register a webhook watch on a price change or service status transition. HMAC-SHA256 signed POST deliveries. 90-day TTL, default fire cap 100, per-token cap 25.",
        "tier": 1,
        "credits": 1,
        "category": "ai-webhooks",
        "input": {
          "spec": { "type": "price", "model": "Claude Opus 4.7", "field": "blended", "op": "lt", "threshold": 30 },
          "callback_url": "https://your-agent.example.com/hook",
          "secret": "optional shared secret"
        }
      }
    }
  ],
  "freeEndpoints": [
    {
      "resource": "https://tensorfeed.ai/api/news",
      "description": "Latest AI news articles aggregated from 15+ sources. Free, no auth."
    },
    {
      "resource": "https://tensorfeed.ai/api/status",
      "description": "Real-time AI service status (Claude, OpenAI, Gemini, Mistral, Cohere, Replicate, Hugging Face). Free, no auth."
    },
    {
      "resource": "https://tensorfeed.ai/api/models",
      "description": "AI model pricing, context windows, capabilities. Free, no auth."
    },
    {
      "resource": "https://tensorfeed.ai/api/benchmarks",
      "description": "AI model benchmark scores. Free, no auth."
    },
    {
      "resource": "https://tensorfeed.ai/api/history",
      "description": "Daily historical snapshots of pricing, models, benchmarks, status, and agent activity. Free, no auth. Single-day raw payload; aggregated views are premium.",
      "perDate": "https://tensorfeed.ai/api/history/{YYYY-MM-DD}/{type}"
    },
    {
      "resource": "https://tensorfeed.ai/api/preview/routing",
      "description": "Free top-1 routing recommendation. Rate-limited to 5 calls per UTC day per IP. Premium /api/premium/routing has no rate limit and returns top-N with full breakdown."
    },
    {
      "resource": "https://tensorfeed.ai/api/agents/activity",
      "description": "Real-time AI agent traffic metrics on tensorfeed.ai. Free, no auth."
    },
    {
      "resource": "https://tensorfeed.ai/api/gpu/pricing",
      "description": "Aggregated GPU rental pricing across cloud GPU marketplaces (Vast.ai + RunPod). Cheapest on-demand and spot per canonical GPU. Refreshed every 4 hours. Free, no auth."
    },
    {
      "resource": "https://tensorfeed.ai/api/gpu/pricing/cheapest",
      "description": "Top 3 cheapest current GPU offers for one canonical GPU class. Params: ?gpu=H100&type=on_demand|spot. Agent-friendly entry point. Free, no auth."
    }
  ],
  "sdks": [
    {
      "language": "python",
      "package": "tensorfeed",
      "registry": "pypi",
      "install": "pip install tensorfeed",
      "withWeb3": "pip install 'tensorfeed[web3]'",
      "url": "https://pypi.org/project/tensorfeed/"
    },
    {
      "language": "typescript",
      "package": "tensorfeed",
      "registry": "npm",
      "install": "npm install tensorfeed",
      "url": "https://www.npmjs.com/package/tensorfeed"
    },
    {
      "language": "mcp",
      "package": "@tensorfeed/mcp-server",
      "registry": "npm",
      "install": "npx -y @tensorfeed/mcp-server",
      "envVar": "TENSORFEED_TOKEN",
      "url": "https://www.npmjs.com/package/@tensorfeed/mcp-server",
      "manifest": "https://github.com/RipperMercs/tensorfeed/blob/main/mcp-server/server.json"
    }
  ],
  "lastUpdated": "2026-04-29T00:00:00Z"
}