TopNetworks API

// "Before I set my timeout, what is OpenAI's p95 right now?"
const data = await pay(
  "https://topnetworks.com/api/v1/latency?provider=openai&window=1h"
).then(r => r.json())
// { p50_ms: 312, p95_ms: 1840, p99_ms: 4200, avg_ms: 480,
//   ttft_estimate_ms: 192, trend: "stable", uptime_pct_in_window: 100 }

const timeout = Math.round(data.p95_ms * 1.2)  // p95 + 20% buffer
console.log("Use timeout:", timeout, "ms")       // 2208ms

const { failover_chain } = await fetch(
  "https://topnetworks.com/api/v1/failover?primary=openai&task=llm&max_cost_per_1m=2.00"
).then(r => r.json())

// failover_chain: [
//   { provider_id: "anthropic", status: "operational", score: 88,
//     response_time_ms: 390, input_per_1m_usd: 3.00,
//     reason: "Operational — 20% more expensive than OpenAI" },
//   { provider_id: "groq", status: "operational", score: 85,
//     response_time_ms: 180, input_per_1m_usd: 0.59,
//     reason: "Operational and fast — 76% cheaper than OpenAI" },
// ]

for (const p of failover_chain) {
  if (p.status === 'operational') {
    reroute(p.provider_id)  // try in order
    break
  }
}

const { recommendations } = await fetch(
  "https://topnetworks.com/api/v1/recommend?task=llm&avoid=openai&limit=3"
).then(r => r.json())

// [{ id: "anthropic", name: "Anthropic", status: "operational",
//    response_time_ms: 98, score: 90, reason: "Operational and fast" },
//  { id: "groq", ... }, ...]

const fallback = recommendations[0]?.id  // "anthropic"

const { incidents, summary } = await fetch(
  "https://topnetworks.com/api/v1/incidents?hours=24"
).then(r => r.json())

// summary: { total_incidents: 2, outages: 1, degraded: 1, ongoing: 1 }
// incidents[0]: { provider_id: "scaleway", severity: "degraded",
//   started_at: "2026-03-15T...", duration_minutes: 45, ongoing: true }

const data = await fetch(
  "https://topnetworks.com/api/v1/cost-estimate" +
  "?provider=openai&input_tokens=10000&output_tokens=2000&cached_tokens=5000"
).then(r => r.json())

// {
//   model: "gpt-4o",
//   rates: { input_per_1m_usd: 2.50, output_per_1m_usd: 10.00, cache_discount_pct: 50 },
//   breakdown: { input_cost_usd: 0.0125, cached_cost_usd: 0.00625, output_cost_usd: 0.02 },
//   estimated_total_usd: 0.038750,
//   cache_savings_usd: 0.00625,
//   cheaper_alternatives: [
//     { provider_id: "groq", input_per_1m_usd: 0.59,
//       estimated_total_usd: 0.009900, savings_pct: 74 }
//   ]
// }

const { pricing } = await fetch(
  "https://topnetworks.com/api/v1/pricing?task=llm&compare=true"
).then(r => r.json())
// Sorted cheapest input first:
// [{ provider_id: "deepinfra", model: "llama-3.3-70b",
//    pricing: { input_per_1m_tokens: 0.23, output_per_1m_tokens: 0.40 } },
//  { provider_id: "groq", ... }, ...]

const { models } = await fetch(
  "https://topnetworks.com/api/v1/models?task=llm&vision=true&min_context=128000"
).then(r => r.json())
// [{ provider_id: "google-gemini", model_id: "gemini-2.0-flash",
//    context_window: 1048576, max_output_tokens: 8192,
//    capabilities: { vision: true, function_calling: true, json_mode: true },
//    knowledge_cutoff: "2025-01" }, ...]

const { rate_limits } = await fetch(
  "https://topnetworks.com/api/v1/rate-limits?provider=openai"
).then(r => r.json())
// [{ tier: "free", limits: { requests_per_minute: 3, tokens_per_minute: 40000 } },
//  { tier: "tier1", limits: { requests_per_minute: 500, tokens_per_minute: 200000 } }]

const { benchmarks, meta } = await fetch(
  "https://topnetworks.com/api/v1/benchmarks?task=coding&limit=5"
).then(r => r.json())
// meta.sorted_by: "humaneval"
// benchmarks[0]: { provider_id: "openai", model_id: "o3",
//   scores: { humaneval: 98.0, mmlu: 96.7, math: 97.0 } }

import { wrapFetchWithPayment } from 'x402-fetch'
import { createHash } from 'crypto'

const output = JSON.stringify({ result: 'the answer', confidence: 0.98 })
const hash = createHash('sha256').update(output).digest('hex')

// Step 1: register the contract — $0.001
const { id, verify_url } = await pay('https://topnetworks.com/api/v1/register', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    agent_id: 'my-agent-v2',
    schema_version: '1.0.0',
    integrity_hash: hash,
    tags: ['llm', 'structured-output'],
  }),
}).then(r => r.json())

// Step 2: another agent verifies before trusting output — $0.001
const { valid, hash_match } = await pay(`${verify_url}?hash=${hash}`).then(r => r.json())
// { valid: true, hash_match: true, verified_count: 1 }

import { createHash } from 'crypto'

const inputData = await fetchInputFromUpstream()
const hash = createHash('sha256').update(JSON.stringify(inputData)).digest('hex')

// Agent A signs before acting
const receipt = await fetch('https://topnetworks.com/api/v1/sign', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ signer_id: 'pipeline-agent-v3', payload_hash: hash }),
}).then(r => r.json())
// { id: "...", signature: "...", validate_url: "..." }

// Pass receipt.id + hash downstream alongside your output
const output = { result: processInput(inputData), provenance_id: receipt.id, payload_hash: hash }

// Agent B validates before trusting the output
const { valid, signature_valid, hash_match } = await fetch(
  `https://topnetworks.com/api/v1/validate/${output.provenance_id}?hash=${output.payload_hash}`
).then(r => r.json())

if (!valid || !signature_valid || !hash_match) throw new Error('Provenance check failed')