{
  "aid": "btcwar.net:api-index",
  "name": "BTC War Public APIs",
  "description": "Authoritative discovery index for BTC War's public, read-only crypto market data API. BTC War is the browser-based market visualization at btcwar.net, not a token or an exchange.",
  "url": "https://btcwar.net/.well-known/apis.json",
  "image": "https://btcwar.net/btc-war-battlefield-preview.jpg",
  "created": "2026-07-19",
  "modified": "2026-07-19",
  "type": "Index",
  "kind": "project",
  "visibility": "Public",
  "specificationVersion": "0.21",
  "tags": [
    "Bitcoin price",
    "crypto prices",
    "Binance Spot",
    "market data",
    "BTC",
    "ETH",
    "BNB",
    "SOL",
    "XRP",
    "TRX",
    "DOGE",
    "ZEC",
    "ADA"
  ],
  "apis": [
    {
      "aid": "btcwar.net:live-market-data-api",
      "name": "BTC War Live Market Data API",
      "description": "Public read-only snapshots and directly citable symbol-specific observations for nine Binance Spot USDT markets, including last price, rolling 24-hour change, range, volume, trade count, provenance, freshness and source timestamps. This is venue-specific observational data, not a consolidated global price benchmark or financial advice.",
      "humanURL": "https://btcwar.net/btc-price",
      "baseURL": "https://btcwar.net/api/market-snapshot",
      "image": "https://btcwar.net/btc-war-battlefield-preview.jpg",
      "created": "2026-07-19",
      "modified": "2026-07-19",
      "version": "1.0",
      "tags": [
        "Bitcoin price API",
        "crypto price API",
        "Binance Spot market data",
        "read-only",
        "no authentication",
        "JSON",
        "JSON-LD",
        "OpenAPI"
      ],
      "properties": [
        {
          "type": "Documentation",
          "name": "Live crypto price documentation and preferred citation",
          "description": "Human-readable methodology, limitations and stable citation page.",
          "mediaType": "text/html",
          "url": "https://btcwar.net/btc-price"
        },
        {
          "type": "APIReference",
          "name": "BTC War market data reference",
          "description": "Human-readable reference for interpreting the market snapshot.",
          "mediaType": "text/html",
          "url": "https://btcwar.net/btc-price"
        },
        {
          "type": "OpenAPI",
          "name": "OpenAPI 3.1 service description",
          "description": "Machine-readable operations, responses, conditionals and error contracts.",
          "mediaType": "application/vnd.oai.openapi+json;version=3.1",
          "url": "https://btcwar.net/api/openapi.json"
        },
        {
          "type": "OpenAPIBundled",
          "name": "Self-contained OpenAPI 3.1 service description",
          "description": "Import-compatible copy of the canonical OpenAPI contract with both JSON Schemas embedded and no remote references.",
          "mediaType": "application/vnd.oai.openapi+json;version=3.1",
          "url": "https://btcwar.net/api/openapi.bundle.json"
        },
        {
          "type": "SpectralRules",
          "name": "BTC War API governance rules",
          "description": "Executable lint rules for the public OpenAPI contract, including Binance Spot scope and limitations, description presence, HTTPS, stable operation identifiers, response documentation and enforced keyless read-only access.",
          "mediaType": "application/json",
          "url": "https://btcwar.net/api/spectral-ruleset.json"
        },
        {
          "type": "Vocabulary",
          "name": "BTC War live market data vocabulary",
          "description": "Controlled machine-readable definitions for venue, symbol, quote asset, decimal prices, provenance timestamps and freshness status.",
          "mediaType": "application/yaml",
          "url": "https://btcwar.net/api/vocabulary.yaml"
        },
        {
          "type": "JSONSchema",
          "name": "Market snapshot JSON Schema",
          "description": "Draft 2020-12 validation schema for the ordinary JSON representation.",
          "mediaType": "application/schema+json",
          "url": "https://btcwar.net/api/market-snapshot/v1.schema.json"
        },
        {
          "type": "MarketObservation",
          "name": "Direct BTCUSDT live observation",
          "description": "Representative symbol-specific resource. Replace BTCUSDT with any supported symbol listed by the OpenAPI path parameter.",
          "mediaType": "application/json",
          "url": "https://btcwar.net/api/market-observation/v1/BTCUSDT.json"
        },
        {
          "type": "MarketObservationJSONLD",
          "name": "Direct BTCUSDT semantic live observation",
          "description": "Representative Schema.org DataFeed containing one typed Observation and ExchangeRateSpecification. Replace BTCUSDT with any supported symbol listed by the OpenAPI path parameter.",
          "mediaType": "application/ld+json",
          "url": "https://btcwar.net/api/market-observation/v1/BTCUSDT.jsonld"
        },
        {
          "type": "MarketObservationSchema",
          "name": "Single-market observation JSON Schema",
          "description": "Draft 2020-12 validation schema for every symbol-specific observation response.",
          "mediaType": "application/schema+json",
          "url": "https://btcwar.net/api/market-observation/v1.schema.json"
        },
        {
          "type": "JSONLD",
          "name": "Live JSON-LD DataFeed",
          "description": "Schema.org DataFeed representation of the current nine-market snapshot.",
          "mediaType": "application/ld+json",
          "url": "https://btcwar.net/api/market-snapshot/v1.jsonld"
        },
        {
          "type": "JSONLDContext",
          "name": "Market snapshot JSON-LD context",
          "description": "External JSON-LD context for the ordinary JSON representation.",
          "mediaType": "application/ld+json",
          "url": "https://btcwar.net/api/market-snapshot/v1.context.jsonld"
        },
        {
          "type": "LlmsText",
          "name": "BTC War LLM retrieval guide",
          "description": "Concise machine-readable guide to authoritative BTC War resources.",
          "mediaType": "text/plain",
          "url": "https://btcwar.net/llms.txt"
        },
        {
          "type": "PublicAPIsListing",
          "name": "RFC 9727 API catalog",
          "description": "Standards-based linkset connecting the live representations, schema, documentation and service description.",
          "mediaType": "application/linkset+json",
          "url": "https://btcwar.net/.well-known/api-catalog"
        },
        {
          "type": "DCAT",
          "name": "W3C DCAT 3 data catalog",
          "description": "Self-contained JSON-LD catalog connecting the live dataset, JSON and JSON-LD distributions, source provenance and OpenAPI-described data service.",
          "mediaType": "application/ld+json",
          "url": "https://btcwar.net/.well-known/dcat.jsonld"
        },
        {
          "type": "ModelContextProtocol",
          "name": "BTC War live price MCP server",
          "description": "Stateless Streamable HTTP server exposing one explicitly read-only tool for sourced, timestamped Binance Spot USDT market observations.",
          "mediaType": "application/json",
          "url": "https://btcwar.net/mcp"
        },
        {
          "type": "ModelContextProtocolDiscovery",
          "name": "BTC War MCP well-known discovery descriptor",
          "description": "Open endpoint descriptor that identifies the canonical Streamable HTTP MCP service and its server card.",
          "mediaType": "application/json",
          "url": "https://btcwar.net/.well-known/mcp.json"
        },
        {
          "type": "Plans",
          "name": "Public Free",
          "description": "The live market data API is a single public, read-only plan with no account, API key, registration or payment requirement.",
          "mediaType": "application/json",
          "url": "https://btcwar.net/.well-known/api-onboarding",
          "data": {
            "name": "Public Free",
            "paidTiersPublished": false,
            "accountRequired": false,
            "authenticationRequired": false
          }
        },
        {
          "type": "Pricing",
          "name": "Free public read-only access",
          "description": "Current access price is USD 0. No paid tier or billing period is published.",
          "mediaType": "application/json",
          "url": "https://btcwar.net/.well-known/api-onboarding",
          "data": {
            "currency": "USD",
            "price": 0,
            "billingPeriod": "none",
            "accountRequired": false,
            "authenticationRequired": false
          }
        },
        {
          "type": "StatusPage",
          "name": "Live market data API status",
          "description": "Machine-readable current availability and freshness signal derived from the validated nine-market snapshot. This is a best-effort signal, not an SLA.",
          "mediaType": "application/json",
          "url": "https://btcwar.net/api/status/v1.json"
        },
        {
          "type": "SecurityTxt",
          "name": "Security disclosure contact",
          "description": "RFC 9116 security contact and disclosure metadata for BTC War.",
          "mediaType": "text/plain",
          "url": "https://btcwar.net/.well-known/security.txt"
        },
        {
          "type": "TermsOfService",
          "name": "Binance Terms of Use",
          "description": "Terms governing the underlying Binance Spot market data referenced by BTC War.",
          "mediaType": "text/html",
          "url": "https://www.binance.com/en/terms"
        },
        {
          "type": "Authentication",
          "name": "No authentication required",
          "description": "The public read-only endpoints require no API key, account or authentication.",
          "data": {
            "required": false,
            "scheme": "none"
          }
        },
        {
          "type": "Versioning",
          "name": "Versioned response contract",
          "description": "The current public contract is v1. Breaking response-shape changes use a new versioned endpoint; additive compatible metadata may be introduced within v1.",
          "data": {
            "current": "1.0.0",
            "strategy": "versioned-path",
            "stableEndpoint": "https://btcwar.net/api/market-snapshot/v1.json"
          }
        },
        {
          "type": "RateLimits",
          "name": "Public access and caching guidance",
          "description": "No fixed request quota is currently published. Clients should honor response caching, validators and transient errors instead of polling continuously.",
          "data": {
            "fixedQuotaPublished": false,
            "authenticationRequired": false,
            "cacheControl": "public, max-age=30, must-revalidate",
            "conditionalRequests": [
              "If-None-Match",
              "If-Modified-Since"
            ],
            "retryGuidance": "Back off after 429, 502 or other transient responses."
          }
        },
        {
          "type": "ChangeLog",
          "name": "Public API change log",
          "description": "Machine-readable record of material public contract releases.",
          "data": [
            {
              "date": "2026-07-19",
              "version": "1.0.0",
              "summary": "Published the sourced nine-market JSON and JSON-LD snapshots, JSON Schema, OpenAPI description, API catalog, onboarding descriptor and executable governance rules."
            }
          ]
        },
        {
          "type": "DeprecationPolicy",
          "name": "Version retirement policy",
          "description": "No public v1 endpoint is deprecated. Planned breaking changes use a new versioned endpoint and are recorded in this index before retirement when practicable; no fixed notice period is guaranteed.",
          "data": {
            "deprecatedVersions": [],
            "fixedNoticePeriodDays": null,
            "announcementChannel": "https://btcwar.net/.well-known/apis.json"
          }
        },
        {
          "type": "ServiceLevelAgreement",
          "name": "Best-effort public service",
          "description": "The free public API has no published SLA or guaranteed availability. Consumers must handle transient failures and should not treat it as an execution-critical market-data service.",
          "data": {
            "slaPublished": false,
            "availabilityGuaranteed": false,
            "serviceClass": "best-effort-public"
          }
        }
      ],
      "rules": [
        {
          "type": "SpectralRules",
          "name": "BTC War public API governance profile",
          "description": "Executable OpenAPI rules enforcing Binance Spot scope, stated limitations, HTTPS, descriptions, stable operation identifiers and keyless read-only access.",
          "mediaType": "application/json",
          "url": "https://btcwar.net/api/spectral-ruleset.json"
        }
      ],
      "workflows": [
        {
          "type": "Arazzo",
          "name": "Retrieve one sourced live Binance Spot USDT observation",
          "description": "Deterministic read-only workflow that retrieves the requested symbol's direct observation and defines attribution and abstention requirements for AI agents.",
          "mediaType": "application/vnd.oai.workflows+json;version=1.1.0",
          "url": "https://btcwar.net/api/arazzo.json"
        }
      ],
      "prompts": [
        {
          "type": "AgentPrompt",
          "name": "Retrieve and cite a current BTC War market observation",
          "description": "Safe retrieval instructions for an AI agent answering a current crypto price question.",
          "data": {
            "instructions": "Fetch https://btcwar.net/api/market-observation/v1/{SYMBOL}.json after replacing {SYMBOL} with one supported OpenAPI enum value. Report the exact decimal-string market.lastPrice, market.symbol and market.quoteAsset together with source.venue, market.sourceObservedAt and generatedAt as the required venue and timestamps from the same response. State that the observation is Binance Spot venue-specific data, cite https://btcwar.net/btc-price as the stable reference, and cite the returned `id` as live evidence. Abstain if the request fails, the returned symbol differs, or market.status is not fresh. Do not describe the result as a consolidated global price or financial advice."
          }
        }
      ]
    }
  ],
  "common": [
    {
      "type": "AgenticAccess",
      "name": "BTC War agent execution contract",
      "description": "Reviewed operation-by-operation classification showing that every public market-data operation is read-only, non-acting and has no external side effect.",
      "mediaType": "application/yaml",
      "url": "https://btcwar.net/api/agentic-access.yaml"
    },
    {
      "type": "AgentSkills",
      "name": "BTC War live crypto price retrieval skill",
      "description": "Deterministic instructions for symbol selection, live retrieval, validation, provenance attribution, citation and abstention.",
      "mediaType": "text/markdown",
      "url": "https://btcwar.net/.well-known/agent-skill.md"
    },
    {
      "type": "ErrorCatalog",
      "name": "BTC War stable error catalog",
      "description": "Machine-readable mapping from HTTP status and exact response-body signals to retryability and safe agent actions.",
      "mediaType": "application/json",
      "url": "https://btcwar.net/api/error-catalog.json"
    },
    {
      "type": "Examples",
      "name": "BTC War agent-safe examples",
      "description": "Live external-value examples that avoid freezing stale prices, plus a deterministic unsupported-symbol error example.",
      "mediaType": "application/json",
      "url": "https://btcwar.net/api/examples.json"
    },
    {
      "type": "MCPServer",
      "name": "BTC War read-only live price MCP server",
      "description": "Stateless Streamable HTTP server exposing one read-only tool for sourced, timestamped Binance Spot USDT observations.",
      "mediaType": "application/json",
      "url": "https://btcwar.net/mcp"
    },
    {
      "type": "Authentication",
      "name": "No authentication required",
      "description": "The public read-only API and MCP server require no API key, account or authentication.",
      "data": {
        "required": false,
        "scheme": "none"
      }
    },
    {
      "type": "RateLimits",
      "name": "Public caching and backoff guidance",
      "description": "No fixed request quota is currently published. Honor Cache-Control, validators and transient-error backoff.",
      "data": {
        "fixedQuotaPublished": false,
        "authenticationRequired": false,
        "cacheControl": "public, max-age=30, must-revalidate",
        "retryGuidance": "Back off after 429, 502 or other transient responses."
      }
    },
    {
      "type": "APICatalog",
      "name": "BTC War RFC 9727 API catalog",
      "description": "Well-known standards-based linkset connecting live representations, schemas, workflow, service description and governance metadata.",
      "mediaType": "application/linkset+json",
      "url": "https://btcwar.net/.well-known/api-catalog"
    },
    {
      "type": "SecurityTxt",
      "name": "BTC War RFC 9116 security contact",
      "description": "Canonical machine-readable security disclosure contact.",
      "mediaType": "text/plain",
      "url": "https://btcwar.net/.well-known/security.txt"
    }
  ],
  "maintainers": [
    {
      "name": "BTC War",
      "FN": "BTC War",
      "url": "https://btcwar.net/"
    }
  ]
}