kairossignal-com Credits API

openapi: 3.2.0
info:
  title: Kairossignal Com Credits API
  version: 1.0.0
  contact:
    email: support@kairossignal.com
    name: Kairos Signal
  termsOfService: https://kairossignal.com/agents
  description: 'Operations tagged Credits across 2 of this provider''s published API definitions: api.kairossignal.com-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: Credits
paths:
  /v1/credits/balance:
    get:
      summary: Current credit balance for the key in X-API-Key
      parameters:
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
        description: Key from POST /v1/credits/register
      responses:
        '200':
          description: Balance and account identity
          content:
            application/json:
              schema:
                type: object
                properties:
                  credits_balance:
                    type: number
                  agent_name:
                    type: string
                  spending_status:
                    type: string
        '401':
          description: Missing or unknown API key
      tags:
      - Credits
      operationId: getV1CreditsBalance
      x-operation-id-source: derived
    servers:
    - url: https://kairossignal.com
      description: Production
  /v1/credits/pricing:
    get:
      summary: Get full pricing catalog
      responses:
        '200':
          description: Pricing details
          content:
            application/json:
              schema:
                type: object
      tags:
      - Credits
      operationId: getV1CreditsPricing
      x-operation-id-source: derived
    servers:
    - url: https://kairossignal.com
      description: Production
  /v1/credits/purchase:
    post:
      summary: Spend credits on a dataset.
      parameters:
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
        description: Key from POST /v1/credits/register
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - product_key
              properties:
                product_key:
                  type: string
                  example: depin_provenance
                  description: e.g. depin_provenance ($0.49), depin_networks ($0.99), depin_revenue_snapshot ($2.99)
      responses:
        '200':
          description: Purchased; data delivered inline in the response body
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: purchased
                  price_paid:
                    type: number
                  remaining_balance:
                    type: number
                  delivery:
                    type: string
                    example: inline
        '402':
          description: Insufficient credits — the response states the shortfall and how to top up
      tags:
      - Credits
      operationId: postV1CreditsPurchase
      x-operation-id-source: derived
    servers:
    - url: https://kairossignal.com
      description: Production
  /v1/credits/register:
    post:
      summary: Register for free API key + $5 credits (first 3 keys per IP per 30 days)
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                email:
                  type: string
                  format: email
                agent_name:
                  type: string
      responses:
        '200':
          description: API key and credits
          content:
            application/json:
              schema:
                type: object
                properties:
                  api_key:
                    type: string
                  credits_balance:
                    type: number
                  message:
                    type: string
      tags:
      - Credits
      operationId: postV1CreditsRegister
      x-operation-id-source: derived
    servers:
    - url: https://kairossignal.com
      description: Production
  /v1/credits/purchases:
    get:
      operationId: listPurchases
      summary: Your purchase history with verifiable receipts (no charge)
      parameters:
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: purchases with purchase_id, price, payload_sha256
      tags:
      - Credits
    servers:
    - url: https://kairossignal.com
      description: Production
  /v1/credits/purchases/{purchase_id}:
    get:
      operationId: getPurchaseReceipt
      summary: Verify a purchase receipt; ?include=data re-delivers the product free
      parameters:
      - name: purchase_id
        in: path
        required: true
        schema:
          type: string
      - name: include
        in: query
        required: false
        schema:
          type: string
          enum:
          - data
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: receipt (price, payload_sha256, purchased_at); retry after a dropped connection is a GET, never a second charge
        '404':
          description: no purchase with this id for this key
      tags:
      - Credits
    servers:
    - url: https://kairossignal.com
      description: Production
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
x-refined-from:
- api.kairossignal.com-openapi.json
- kairossignal-com-openapi.json