kairossignal-com X402 API

openapi: 3.2.0
info:
  title: Kairossignal Com X402 API
  version: 1.0.0
  description: 'Operations tagged x402 across 3 of this provider''s published API definitions: api.kairossignal.com-openapi.json, kairossignal.com-x402-openapi.json, kairossignal-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://kairossignal.com
  description: Production
tags:
- name: X402
paths:
  /x402/v1/data/depin_provenance:
    get:
      operationId: x402_depin_provenance
      summary: DePIN product depin_provenance ($0.49 per request, x402)
      description: 'First-party supply snapshot for every in-scope DePIN network /v1/supply serves: infrastructure series (node counts, capacity, utilisation, chain state) only where a network publishes them, and for most networks only token supply and holder counts read from the token contract. Each value with verify_yourself and as_of; series under a quality incident or not read in 26 h are listed under withheld_not_live, scope-ruled symbols under excluded_by_scope.'
      tags:
      - X402
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.49'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Data inline, with a PAYMENT-RESPONSE settlement receipt
          content:
            application/json:
              schema:
                type: object
        '402':
          description: 'Payment Required: the PAYMENT-REQUIRED header and the body carry the offer (standard x402 exact on Base first)'
    servers:
    - url: https://kairossignal.com
      description: Production
  /x402/v1/data/depin_networks:
    get:
      operationId: x402_depin_networks
      summary: DePIN product depin_networks ($0.99 per request, x402)
      description: 'The DePIN network catalog: one row per catalog entry plus the on-chain symbols with no catalog row (Bittensor subnets and ruled-out rows included, so n_networks counts entries, not live DePIN networks), each with its telemetry tier (first_party_telemetry / onchain_only / market_data_only / catalog_only / no_live_data; out-of-scope rows carry their ruling tier), live-coverage flags and a market summary. Rows are catalog metadata; measured values with source, as_of and verify_yourself are on /v1/supply and /v1/network/.'
      tags:
      - X402
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.99'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Data inline, with a PAYMENT-RESPONSE settlement receipt
          content:
            application/json:
              schema:
                type: object
        '402':
          description: 'Payment Required: the PAYMENT-REQUIRED header and the body carry the offer (standard x402 exact on Base first)'
    servers:
    - url: https://kairossignal.com
      description: Production
  /x402/v1/data/depin_revenue_snapshot:
    get:
      operationId: x402_depin_revenue_snapshot
      summary: DePIN product depin_revenue_snapshot ($2.99 per request, x402)
      description: 'DefiLlama figures for the in-scope DePIN networks our DefiLlama collector maps (n_networks_available states how many): REV_24H / REV_30D and DL_FEES_* are DefiLlama fees, DL_REV_* DefiLlama dailyRevenue; each value with measures, as_of and the DefiLlama URL. An aggregator''s figures, not fees read from each chain.'
      tags:
      - X402
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '2.99'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Data inline, with a PAYMENT-RESPONSE settlement receipt
          content:
            application/json:
              schema:
                type: object
        '402':
          description: 'Payment Required: the PAYMENT-REQUIRED header and the body carry the offer (standard x402 exact on Base first)'
    servers:
    - url: https://kairossignal.com
      description: Production
  /x402/v1/data/node_quality_score:
    get:
      operationId: x402_node_quality_score
      summary: DePIN product node_quality_score ($4.99 per request, x402)
      description: Raw vs active node counts for networks with a live first-party count, each with its as_of; a quality-adjusted count and an A-F grade only where an active count is measured beside the raw one in the same collection cycle, otherwise UNGRADED with the reason. Stale or incident-covered counts are withheld and listed.
      tags:
      - X402
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '4.99'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Data inline, with a PAYMENT-RESPONSE settlement receipt
          content:
            application/json:
              schema:
                type: object
        '402':
          description: 'Payment Required: the PAYMENT-REQUIRED header and the body carry the offer (standard x402 exact on Base first)'
    servers:
    - url: https://kairossignal.com
      description: Production
  /x402/v1/data/dilution_risk_map:
    get:
      operationId: x402_dilution_risk_map
      summary: DePIN product dilution_risk_map ($4.99 per request, x402)
      description: FDV/MC dilution ratios for in-scope DePIN networks whose CoinGecko market cap is live (quote within 48 h), with the measurement contract and classification thresholds; scope-ruled, stale and duplicate-coin rows are listed under excluded.
      tags:
      - X402
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '4.99'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Data inline, with a PAYMENT-RESPONSE settlement receipt
          content:
            application/json:
              schema:
                type: object
        '402':
          description: 'Payment Required: the PAYMENT-REQUIRED header and the body carry the offer (standard x402 exact on Base first)'
    servers:
    - url: https://kairossignal.com
      description: Production
  /x402/v1/data/gpu_supply_demand:
    get:
      operationId: x402_gpu_supply_demand
      summary: DePIN product gpu_supply_demand ($9.99 per request, x402)
      description: io.net GPU inventory by model (latest inventory capture) and Akash GPU/CPU/storage totals; Golem only when live (withheld since 2026-10-02; it never carried a GPU figure); cross-network sums state their derivation.
      tags:
      - X402
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '9.99'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Data inline, with a PAYMENT-RESPONSE settlement receipt
          content:
            application/json:
              schema:
                type: object
        '402':
          description: 'Payment Required: the PAYMENT-REQUIRED header and the body carry the offer (standard x402 exact on Base first)'
    servers:
    - url: https://kairossignal.com
      description: Production
  /x402/v1/data/sector_health_index:
    get:
      operationId: x402_sector_health_index
      summary: DePIN product sector_health_index ($4.99 per request, x402)
      description: Category coverage-and-market index (0-100, A-F bands; 60 of 100 points are our data coverage of the members, not network health), with methodology and components.
      tags:
      - X402
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '4.99'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Data inline, with a PAYMENT-RESPONSE settlement receipt
          content:
            application/json:
              schema:
                type: object
        '402':
          description: 'Payment Required: the PAYMENT-REQUIRED header and the body carry the offer (standard x402 exact on Base first)'
    servers:
    - url: https://kairossignal.com
      description: Production
  /x402/v1/data/geo_concentration:
    get:
      operationId: x402_geo_concentration
      summary: DePIN product geo_concentration ($4.99 per request, x402)
      description: Country counts as each network's own API reports them (each with countries_basis, as_of and verify_url; not always a node census), plus a ThreeFold per-country node breakdown from its latest gridproxy snapshot. Stale counts are withheld.
      tags:
      - X402
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '4.99'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Data inline, with a PAYMENT-RESPONSE settlement receipt
          content:
            application/json:
              schema:
                type: object
        '402':
          description: 'Payment Required: the PAYMENT-REQUIRED header and the body carry the offer (standard x402 exact on Base first)'
    servers:
    - url: https://kairossignal.com
      description: Production
  /x402/v1/data/dev_velocity:
    get:
      operationId: x402_dev_velocity
      summary: DePIN product dev_velocity ($4.99 per request, x402)
      description: GitHub public-repository metrics per in-scope DePIN network with a tracked repository, each row dated (our GitHub API read); stale readings are withheld.
      tags:
      - X402
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '4.99'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Data inline, with a PAYMENT-RESPONSE settlement receipt
          content:
            application/json:
              schema:
                type: object
        '402':
          description: 'Payment Required: the PAYMENT-REQUIRED header and the body carry the offer (standard x402 exact on Base first)'
    servers:
    - url: https://kairossignal.com
      description: Production
  /x402/v1/data/competitive_landscape:
    get:
      operationId: x402_competitive_landscape
      summary: DePIN product competitive_landscape ($9.99 per request, x402)
      description: CoinGecko market-cap share within a hand-coded member list per DePIN category; HHI concentration only where at least 3 members hold a live market cap.
      tags:
      - X402
      security: []
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '9.99'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Data inline, with a PAYMENT-RESPONSE settlement receipt
          content:
            application/json:
              schema:
                type: object
        '402':
          description: 'Payment Required: the PAYMENT-REQUIRED header and the body carry the offer (standard x402 exact on Base first)'
    servers:
    - url: https://kairossignal.com
      description: Production
  /x402/v1/data/market_regime:
    get:
      operationId: market_regime
      summary: DePIN product market_regime ($14.99 per request, x402)
      description: 'Rule-based regime label (regime_probabilities are normalised rule votes, not calibrated), 0-100 stability score, a largest-Lyapunov estimate with its surrogate-test p-value, persistent-homology summaries and a Koopman/DMD walk-forward RMSE beside a persistence-of-returns baseline, for one symbol from Binance spot hourly closes only; it describes the window, not a price prediction. Query: symbol (default BTCUSDT; a symbol Binance spot does not trade is refused, nothing settles), days 9-120 (default 30).'
      parameters:
      - name: PAYMENT-SIGNATURE
        in: header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Data inline + PAYMENT-RESPONSE settlement confirmation
        '402':
          description: Payment required — PAYMENT-REQUIRED header carries the options
        '409':
          description: Payment conflicts with another resource or needs reconciliation; do not pay again
        '422':
          description: 'The request can never be satisfied (market_regime: days outside 9-120 or not an integer, or a symbol Binance spot does not trade). Body {unavailable: {reason, retry_after_s: null}}; no offer is made and nothing is charged'
        '503':
          description: 'An input is down or the delivery is not live (body {unavailable: {reason, retry_after_s}} with Retry-After; nothing settled), or the receipt is unavailable (retain payment id for reconciliation)'
      tags:
      - X402
    servers:
    - url: https://kairossignal.com
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
x-refined-from:
- api.kairossignal.com-openapi.json
- kairossignal.com-x402-openapi.json
- kairossignal-com-openapi.json