BTC War Live Market Data API Market data API

openapi: 3.2.0
info:
  title: BTC War Live Market data API
  version: 1.0.0
  summary: Live Binance Spot BTCUSDT, ETHUSDT, BNBUSDT, SOLUSDT, XRPUSDT, TRXUSDT, DOGEUSDT, ZECUSDT and ADAUSDT snapshots in JSON and JSON-LD.
  description: Read-only, machine-verifiable snapshots of nine Binance Spot markets quoted in USDT. BTC War exposes venue-specific observations with source timestamps, provenance, freshness and limitations; it does not provide consolidated global prices, predictions, trading signals or financial advice. This bundled representation contains no remote JSON Schema references for importers that cannot dereference external URLs.
  contact:
    name: BTC War
    url: https://btcwar.net/
  x-retrieval:
    supportedIntents:
    - live Binance Spot crypto price API
    - machine-readable BTCUSDT ETHUSDT SOLUSDT XRPUSDT prices
    - nine-market USDT price snapshot
    - crypto price JSON-LD DataFeed
    - OpenAPI crypto market data source
    preferredCitations:
    - https://btcwar.net/btc-price
    liveEvidenceUrls:
    - https://btcwar.net/api/market-snapshot/v1.json
    - https://btcwar.net/api/market-snapshot/v1.jsonld
    - https://btcwar.net/api/market-observation/v1/BTCUSDT.json
    - https://btcwar.net/api/market-observation/v1/BTCUSDT.jsonld
    citationGuidance: Use https://btcwar.net/btc-price as the stable reference URI. Use the live JSON or JSON-LD URL as direct evidence for a current quote and report source.venue, sourceObservedAt and generatedAt.
    sourceCodeStatus:
      applicationSource: private
      publicRepositoryScope: project documentation only
      openSourceLicenseGranted: false
    dataLicense:
      name: Binance Terms of Use
      url: https://www.binance.com/en/terms
    requiredAttributionFields:
    - symbol
    - source.venue
    - quoteAsset
    - sourceObservedAt
    - generatedAt
    unsupportedIntents:
    - consolidated global crypto price
    - fiat USD benchmark
    - historical price series
    - price forecast
    - trading signal
    - financial advice
  x-canonical-service-description: https://btcwar.net/api/openapi.json
  x-bundled-service-description: https://btcwar.net/api/openapi.bundle.json
servers:
- url: https://btcwar.net
  description: Production
security: []
tags:
- name: Market data
  description: Sourced and timestamped Binance Spot observations.
paths:
  /api/market-snapshot/v1.json:
    get:
      operationId: getLiveMarketSnapshot
      summary: Get the current nine-market snapshot
      description: Public, read-only endpoint; no API key or authentication is required. Returns BTCUSDT, ETHUSDT, BNBUSDT, SOLUSDT, XRPUSDT, TRXUSDT, DOGEUSDT, ZECUSDT and ADAUSDT rolling 24-hour ticker observations. Decimal values are strings to preserve source precision. generatedAt is BTC War response-generation time; sourceObservedAt is the Binance closeTime for each market. Responses are cached for at most 30 seconds and fail closed if any required market is missing, invalid or stale.
      security: []
      tags:
      - Market data
      parameters:
      - $ref: '#/components/parameters/IfNoneMatch'
      - $ref: '#/components/parameters/IfModifiedSince'
      externalDocs:
        description: Canonical human-readable market page
        url: https://btcwar.net/btc-price
      responses:
        '200':
          description: A complete, fresh, sourced nine-market snapshot.
          headers:
            Cache-Control:
              description: Browser cache lifetime.
              schema:
                type: string
            Content-Digest:
              description: RFC 9530 SHA-256 digest of the exact response body.
              schema:
                type: string
                pattern: ^sha-256=:[A-Za-z0-9+/]+={0,2}:$
            ETag:
              description: SHA-256 validator for this exact snapshot.
              schema:
                type: string
            Last-Modified:
              description: HTTP-date form of generatedAt for this exact snapshot.
              schema:
                type: string
                format: http-date
            Link:
              description: Canonical and RFC 8574 cite-as page, JSON-LD context, alternate JSON-LD representation, validation schema, API catalog, service description and upstream methodology links.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketSnapshot'
              examples:
                currentLiveSnapshot:
                  summary: Current live nine-market response
                  description: Fetch this URI for current values. Prices change continuously; cite source.venue, sourceObservedAt and generatedAt from the retrieved response rather than treating documentation values as a quote.
                  externalValue: https://btcwar.net/api/market-snapshot/v1.json
        '304':
          description: The current snapshot matches If-None-Match or has not changed since If-Modified-Since.
          headers:
            Cache-Control:
              $ref: '#/components/headers/CacheControl'
            Content-Digest:
              $ref: '#/components/headers/ContentDigest'
            ETag:
              $ref: '#/components/headers/ETag'
            Last-Modified:
              $ref: '#/components/headers/LastModified'
            Link:
              $ref: '#/components/headers/Link'
        '405':
          description: Only GET and HEAD are supported.
          headers:
            Allow:
              $ref: '#/components/headers/AllowGetHead'
        '502':
          description: A complete and trustworthy live snapshot is temporarily unavailable.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                required:
                - error
                properties:
                  error:
                    const: Live market snapshot unavailable
                    description: Stable error message indicating that BTC War refused to publish an incomplete, invalid or stale snapshot.
              example:
                error: Live market snapshot unavailable
    head:
      operationId: headLiveMarketSnapshot
      summary: Inspect live snapshot metadata
      description: Public, read-only endpoint; no API key or authentication is required. Returns the same status and response headers as GET without a response body.
      security: []
      tags:
      - Market data
      parameters:
      - $ref: '#/components/parameters/IfNoneMatch'
      - $ref: '#/components/parameters/IfModifiedSince'
      responses:
        '200':
          description: Snapshot metadata is available.
          headers:
            Cache-Control:
              $ref: '#/components/headers/CacheControl'
            Content-Digest:
              $ref: '#/components/headers/ContentDigest'
            ETag:
              $ref: '#/components/headers/ETag'
            Last-Modified:
              $ref: '#/components/headers/LastModified'
            Link:
              $ref: '#/components/headers/Link'
        '304':
          description: The current snapshot matches If-None-Match or has not changed since If-Modified-Since.
          headers:
            Cache-Control:
              $ref: '#/components/headers/CacheControl'
            Content-Digest:
              $ref: '#/components/headers/ContentDigest'
            ETag:
              $ref: '#/components/headers/ETag'
            Last-Modified:
              $ref: '#/components/headers/LastModified'
            Link:
              $ref: '#/components/headers/Link'
        '405':
          description: Only GET and HEAD are supported.
          headers:
            Allow:
              $ref: '#/components/headers/AllowGetHead'
        '502':
          description: A complete and trustworthy live snapshot is temporarily unavailable.
  /api/market-snapshot/v1.jsonld:
    get:
      operationId: getLiveMarketSnapshotJsonLd
      summary: Get typed live price observations as JSON-LD
      description: Public, read-only endpoint; no API key or authentication is required. Returns the same complete nine-market Binance Spot snapshot as an explicit Schema.org DataFeed. Each DataFeedItem contains an Observation whose observationAbout is an ExchangeRateSpecification with a UnitPriceSpecification. Decimal prices are strings that preserve Binance source precision; currency is the base asset and priceCurrency is USDT. dateModified is BTC War generation time; observationDate is Binance closeTime. The response fails closed if any required market is missing, invalid or stale.
      security: []
      tags:
      - Market data
      parameters:
      - $ref: '#/components/parameters/IfNoneMatch'
      - $ref: '#/components/parameters/IfModifiedSince'
      externalDocs:
        description: Canonical human-readable market page
        url: https://btcwar.net/btc-price
      responses:
        '200':
          description: A complete, fresh and explicitly typed nine-market JSON-LD feed.
          headers:
            Cache-Control:
              description: Browser cache lifetime.
              schema:
                type: string
            Content-Digest:
              description: RFC 9530 SHA-256 digest of the exact JSON-LD response body.
              schema:
                type: string
                pattern: ^sha-256=:[A-Za-z0-9+/]+={0,2}:$
            ETag:
              description: SHA-256 validator for this exact JSON-LD representation.
              schema:
                type: string
            Last-Modified:
              description: HTTP-date form of the shared generatedAt value.
              schema:
                type: string
                format: http-date
            Link:
              description: Canonical and RFC 8574 cite-as page, alternate ordinary JSON representation, validation schema, API catalog, service description and upstream methodology links.
              schema:
                type: string
          content:
            application/ld+json:
              schema:
                type: object
                additionalProperties: true
                required:
                - '@context'
                - '@type'
                - '@id'
                - dateModified
                - license
                - dataFeedElement
                properties:
                  '@context':
                    const: https://schema.org/
                    description: Schema.org vocabulary context used by this JSON-LD document.
                  '@type':
                    const: DataFeed
                    description: Schema.org type identifying the document as a data feed.
                  '@id':
                    const: https://btcwar.net/api/market-snapshot/v1.json
                    description: Stable identifier shared with the canonical ordinary JSON snapshot.
                  dateModified:
                    type: string
                    format: date-time
                    description: UTC time when BTC War generated this complete feed.
                  license:
                    type: object
                    additionalProperties: false
                    required:
                    - '@type'
                    - name
                    - url
                    properties:
                      '@type':
                        const: CreativeWork
                      name:
                        const: Binance Terms of Use
                      url:
                        const: https://www.binance.com/en/terms
                    description: Terms governing the underlying Binance Spot market data.
                  dataFeedElement:
                    type: array
                    minItems: 9
                    maxItems: 9
                    uniqueItems: true
                    description: Exactly nine DataFeedItem objects, one for each supported Binance Spot USDT market.
                    items:
                      type: object
                      additionalProperties: true
                      required:
                      - '@type'
                      - identifier
                      - dateModified
                      - item
                      properties:
                        '@type':
                          const: DataFeedItem
                          description: Schema.org wrapper for one market observation.
                        identifier:
                          description: Binance Spot symbol for this feed item.
                          enum:
                          - BTCUSDT
                          - ETHUSDT
                          - BNBUSDT
                          - SOLUSDT
                          - XRPUSDT
                          - TRXUSDT
                          - DOGEUSDT
                          - ZECUSDT
                          - ADAUSDT
                        dateModified:
                          type: string
                          format: date-time
                          description: UTC BTC War generation time shared by all items in this feed.
                        item:
                          type: object
                          additionalProperties: true
                          required:
                          - '@type'
                          - identifier
                          - observationAbout
                          - observationDate
                          - value
                          - unitText
                          properties:
                            '@type':
                              const: Observation
                              description: Schema.org observation of the latest Binance Spot trade price.
                            identifier:
                              description: Binance Spot symbol observed by this item.
                              enum:
                              - BTCUSDT
                              - ETHUSDT
                              - BNBUSDT
                              - SOLUSDT
                              - XRPUSDT
                              - TRXUSDT
                              - DOGEUSDT
                              - ZECUSDT
                              - ADAUSDT
                            observationDate:
                              type: string
                              format: date-time
                              description: UTC Binance closeTime for this market observation.
                            value:
                              type: string
                              pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]+)?$
                              description: Latest Binance Spot trade price as a non-negative decimal string in USDT per one base asset.
                            unitText:
                              description: Human-readable unit for value.
                              enum:
                              - USDT per BTC
                              - USDT per ETH
                              - USDT per BNB
                              - USDT per SOL
                              - USDT per XRP
                              - USDT per TRX
                              - USDT per DOGE
                              - USDT per ZEC
                              - USDT per ADA
                            observationAbout:
                              type: object
                              additionalProperties: true
                              description: Typed exchange-rate subject for one base asset priced in USDT on Binance Spot.
                              required:
                              - '@type'
                              - currency
                              - currentExchangeRate
                              properties:
                                '@type':
                                  const: ExchangeRateSpecification
                                  description: Schema.org type for the observed base/quote exchange rate.
                                currency:
                                  description: Base asset priced by currentExchangeRate.
                                  enum:
                                  - BTC
                                  - ETH
                                  - BNB
                                  - SOL
                                  - XRP
                                  - TRX
                                  - DOGE
                                  - ZEC
                                  - ADA
                                currentExchangeRate:
                                  type: object
                                  additionalProperties: false
                                  description: Latest Binance Spot price of one base-asset unit in USDT.
                                  required:
                                  - '@type'
                                  - price
                                  - priceCurrency
                                  - referenceQuantity
                                  properties:
                                    '@type':
                                      const: UnitPriceSpecification
                                      description: Schema.org type for a price per reference quantity.
                                    price:
                                      type: string
                                      pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]+)?$
                                      description: Latest Binance Spot trade price encoded as a decimal string.
                                    priceCurrency:
                                      const: USDT
                                      description: Quote asset for the price; USDT is venue-specific and must not be relabelled as a fiat USD benchmark.
                                    referenceQuantity:
                                      type: object
                                      additionalProperties: false
                                      description: One unit of the corresponding base asset.
                                      required:
                                      - '@type'
                                      - value
                                      - unitText
                                      properties:
                                        '@type':
                                          const: QuantitativeValue
                                          description: Schema.org quantity wrapper.
                                        value:
                                          const: 1
                                          description: The price applies to exactly one base-asset unit.
                                        unitText:
                                          description: Base asset unit represented by the reference quantity.
                                          enum:
                                          - BTC
                                          - ETH
                                          - BNB
                                          - SOL
                                          - XRP
                                          - TRX
                                          - DOGE
                                          - ZEC
                                          - ADA
              examples:
                currentLiveJsonLdFeed:
                  summary: Current live typed price feed
                  description: Fetch this URI for current values. Prices change continuously; cite the market identifier, observationDate and dateModified from the retrieved feed.
                  externalValue: https://btcwar.net/api/market-snapshot/v1.jsonld
        '304':
          description: The current JSON-LD representation matches the supplied validator.
          headers:
            Cache-Control:
              $ref: '#/components/headers/CacheControl'
            Content-Digest:
              $ref: '#/components/headers/ContentDigest'
            ETag:
              $ref: '#/components/headers/ETag'
            Last-Modified:
              $ref: '#/components/headers/LastModified'
            Link:
              $ref: '#/components/headers/Link'
        '405':
          description: Only GET and HEAD are supported.
          headers:
            Allow:
              $ref: '#/components/headers/AllowGetHead'
        '502':
          description: A complete and trustworthy live JSON-LD feed is temporarily unavailable.
          content:
            application/problem+json:
              schema:
                type: object
                additionalProperties: false
                required:
                - error
                properties:
                  error:
                    const: Live market JSON-LD feed unavailable
                    description: Stable error message indicating that BTC War refused to publish an incomplete, invalid or stale JSON-LD feed.
              example:
                error: Live market JSON-LD feed unavailable
    head:
      operationId: headLiveMarketSnapshotJsonLd
      summary: Inspect live JSON-LD feed metadata
      description: Public, read-only endpoint; no API key or authentication is required. Returns the same status and response headers as GET without a response body.
      security: []
      tags:
      - Market data
      parameters:
      - $ref: '#/components/parameters/IfNoneMatch'
      - $ref: '#/components/parameters/IfModifiedSince'
      responses:
        '200':
          description: JSON-LD feed metadata is available.
          headers:
            Cache-Control:
              $ref: '#/components/headers/CacheControl'
            Content-Digest:
              $ref: '#/components/headers/ContentDigest'
            ETag:
              $ref: '#/components/headers/ETag'
            Last-Modified:
              $ref: '#/components/headers/LastModified'
            Link:
              $ref: '#/components/headers/Link'
        '304':
          description: The current JSON-LD representation matches the supplied validator.
          headers:
            Cache-Control:
              $ref: '#/components/headers/CacheControl'
            Content-Digest:
              $ref: '#/components/headers/ContentDigest'
            ETag:
              $ref: '#/components/headers/ETag'
            Last-Modified:
              $ref: '#/components/headers/LastModified'
            Link:
              $ref: '#/components/headers/Link'
        '405':
          description: Only GET and HEAD are supported.
          headers:
            Allow:
              $ref: '#/components/headers/AllowGetHead'
        '502':
          description: A complete and trustworthy live JSON-LD feed is temporarily unavailable.
  /api/market-observation/v1/{symbol}.json:
    get:
      operationId: getLiveMarketObservation
      summary: Get one directly citable live market observation
      description: Public, read-only endpoint; no API key or authentication is required. Selects one supported symbol from BTC War's complete, validated nine-market Binance Spot snapshot and returns its exact decimal-string values with shared source, provenance, freshness and generation timestamps. The endpoint fails closed when the complete source snapshot is unavailable.
      security: []
      tags:
      - Market data
      parameters:
      - name: symbol
        in: path
        required: true
        description: Supported Binance Spot USDT market symbol.
        schema:
          type: string
          enum:
          - BTCUSDT
          - ETHUSDT
          - BNBUSDT
          - SOLUSDT
          - XRPUSDT
          - TRXUSDT
          - DOGEUSDT
          - ZECUSDT
          - ADAUSDT
      - $ref: '#/components/parameters/IfNoneMatch'
      - $ref: '#/components/parameters/IfModifiedSince'
      externalDocs:
        description: Canonical human-readable market page
        url: https://btcwar.net/btc-price
      responses:
        '200':
          description: One fresh, sourced Binance Spot market observation.
          headers:
            Cache-Control:
              $ref: '#/components/headers/CacheControl'
            Content-Digest:
              $ref: '#/components/headers/ContentDigest'
            ETag:
              $ref: '#/components/headers/ETag'
            Last-Modified:
              $ref: '#/components/headers/LastModified'
            Link:
              $ref: '#/components/headers/Link'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketObservation'
              examples:
                currentBtcObservation:
                  summary: Current BTCUSDT observation
                  description: Fetch this URI for the current venue-specific value and cite its source, sourceObservedAt and generatedAt fields.
                  externalValue: https://btcwar.net/api/market-observation/v1/BTCUSDT.json
        '304':
          description: The current observation matches If-None-Match or has not changed since If-Modified-Since.
        '404':
          description: The requested market symbol is not supported.
          content:
            application/problem+json:
              schema:
                type: object
                additionalProperties: false
                required:
                - error
                - supportedSymbols
                properties:
                  error:
                    const: Unsupported market symbol
                  supportedSymbols:
                    type: array
                    items:
                      type: string
        '405':
          description: Only GET and HEAD are supported.
          headers:
            Allow:
              $ref: '#/components/headers/AllowGetHead'
        '502':
          description: A complete and trustworthy source snapshot is temporarily unavailable.
    head:
      operationId: headLiveMarketObservation
      summary: Get one live market observation's validators without a body
      description: Public, read-only endpoint; no API key or authentication is required. Returns the same status and metadata headers as GET without the response body.
      security: []
      tags:
      - Market data
      parameters:
      - name: symbol
        in: path
        required: true
        description: Supported Binance Spot USDT market symbol.
        schema:
          type: string
          enum:
          - BTCUSDT
          - ETHUSDT
          - BNBUSDT
          - SOLUSDT
          - XRPUSDT
          - TRXUSDT
          - DOGEUSDT
          - ZECUSDT
          - ADAUSDT
      - $ref: '#/components/parameters/IfNoneMatch'
      - $ref: '#/components/parameters/IfModifiedSince'
      responses:
        '200':
          description: Observation metadata headers without a body.
        '304':
          description: The current observation matches the supplied validator.
        '404':
          description: The requested market symbol is not supported.
        '405':
          description: Only GET and HEAD are supported.
        '502':
          description: A complete and trustworthy source snapshot is temporarily unavailable.
  /api/market-observation/v1/{symbol}.jsonld:
    get:
      operationId: getLiveMarketObservationJsonLd
      summary: Get one directly citable semantic live market observation
      description: Public, read-only endpoint; no API key or authentication is required. Returns one supported Binance Spot USDT market as an explicit Schema.org DataFeed containing one typed Observation and ExchangeRateSpecification. Exact decimal values, venue, source timestamps, freshness and rolling 24-hour statistics are derived from the same validated source snapshot as the ordinary JSON representation. The endpoint fails closed when the complete source snapshot is unavailable.
      security: []
      tags:
      - Market data
      parameters:
      - name: symbol
        in: path
        required: true
        description: Supported Binance Spot USDT market symbol.
        schema:
          type: string
          enum:
          - BTCUSDT
          - ETHUSDT
          - BNBUSDT
          - SOLUSDT
          - XRPUSDT
          - TRXUSDT
          - DOGEUSDT
          - ZECUSDT
          - ADAUSDT
      - $ref: '#/components/parameters/IfNoneMatch'
      - $ref: '#/components/parameters/IfModifiedSince'
      externalDocs:
        description: Canonical human-readable market page
        url: https://btcwar.net/btc-price
      responses:
        '200':
          description: One fresh, sourced and explicitly typed Binance Spot market observation.
          headers:
            Cache-Control:
              $ref: '#/components/headers/CacheControl'
            Content-Digest:
              $ref: '#/components/headers/ContentDigest'
            ETag:
              $ref: '#/components/headers/ETag'
            Last-Modified:
              $ref: '#/components/headers/LastModified'
            Link:
              $ref: '#/components/headers/Link'
          content:
            application/ld+json:
              schema:
                type: object
                additionalProperties: true
                required:
                - '@context'
                - '@type'
                - '@id'
                - dateModified
                - provider
                - dataFeedElement
                properties:
                  '@context':
                    const: https://schema.org/
                  '@type':
                    const: DataFeed
                  '@id':
                    type: string
                    format: uri
                    pattern: ^https://btcwar\.net/api/market-observation/v1/[A-Z]+USDT\.jsonld$
                  dateModified:
                    type: string
                    format: date-time
                  provider:
                    type: object
                    required:
                    - '@type'
                    - name
                    - url
                    properties:
                      '@type':
                        const: Organization
                      name:
                        const: Binance
                      url:
                        const: https://www.binance.com/
                  dataFeedElement:
                    type: array
                    minItems: 1
                    maxItems: 1
                    items:
                      type: object
                      required:
                      - '@type'
                      - identifier
                      - dateModified
                      - item
                      properties:
                        '@type':
                          const: DataFeedItem
                        identifier:
                          type: string
                        dateModified:
                          type: string
                          format: date-time
                        item:
                          type: object
                          required:
                          - '@type'
                          - identifier
                          - observationAbout
                          - observationDate
                          - value
                          - unitText
                          properties:
                            '@type':
                              const: Observation
                            identifier:
                              type: string
                            observationDate:
                              type: string
                              format: date-time
                            observationAbout:
                              type: object
                              required:
                              - '@type'
                              - currency
                              - currentExchangeRate
                            value:
                              type: object
                              required:
                              - '@value'
                              - '@type'
                            unitText:
                              type: string
              examples:
                currentBtcSemanticObservation:
                  summary: Current typed BTCUSDT observation
                  description: Fetch this URI for the current Schema.org-typed venue-specific observation and cite its identifier, observationDate and dateModified fields.
                  externalValue: https://btcwar.net/api/market-observation/v1/BTC

# --- truncated at 32 KB (63 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/btc-war-live-market-data-api/refs/heads/main/openapi/btc-war-live-market-data-api-market-data-api-openapi.yml