Insidercable X402 API

openapi: 3.2.0
info:
  title: insidercable X402 API
  version: 0.3.0
  summary: Point-in-time financial feeds for AI agents.
  description: 'Every record carries observed_at (when this pipeline first saw it) separately from happened_at (when the event occurred). Records that predate a feed are labelled provenance="pre-existing" with a null observed_at rather than given a fabricated date. Three tiers on the same handlers: free (delayed, capped), subscription token, and x402 pay-per-call in USDC on Base or Arbitrum One. Research data, not investment advice.'
  contact:
    email: hello@insidercable.com
    url: https://insidercable.com
  x-llms-txt: https://insidercable.com/llms.txt
servers:
- url: https://insidercable.com
tags:
- name: X402
  description: pay-per-call door (always 402 until paid)
paths:
  /paid/feed/congress_trades:
    get:
      operationId: paid_congress_trades
      summary: US Congress stock transactions (pay per call, x402)
      description: Always answers 402 until an x402 v2 payment is attached (PAYMENT-SIGNATURE header). Price 0.005 USDC per call on eip155:8453,eip155:42161. Live data, up to 5000 records.
      tags:
      - X402
      x-price-usdc: '0.005'
      x-x402:
        version: 2
        scheme: exact
        network: eip155:8453,eip155:42161
        enabled: true
      parameters:
      - name: ticker
        in: query
        required: false
        schema:
          type: string
        description: Filter to one ticker, e.g. NVDA
      - name: tickers
        in: query
        required: false
        schema:
          type: string
        description: Comma-separated tickers (max 100)
      - name: name
        in: query
        required: false
        schema:
          type: string
        description: Substring match on member name
      - name: chamber
        in: query
        required: false
        schema:
          type: string
          enum:
          - Senate
          - House
      - name: since
        in: query
        required: false
        schema:
          type: string
        description: Only transactions on/after this YYYY-MM-DD
      - name: PAYMENT-SIGNATURE
        in: header
        required: false
        schema:
          type: string
        description: base64 JSON x402 v2 PaymentPayload
      responses:
        '200':
          description: Paid feed envelope
          headers:
            PAYMENT-RESPONSE:
              schema:
                type: string
              description: base64 JSON x402 SettlementResponse (transaction, network, payer)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedEnvelope'
        '402':
          description: 'Payment required (or payment rejected: see error/code)'
          headers:
            PAYMENT-REQUIRED:
              schema:
                type: string
              description: base64 JSON x402 v2 PaymentRequired — identical to the body
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '503':
          description: pay-per-call not enabled on this deployment
  /paid/feed/etf_flows:
    get:
      operationId: paid_etf_flows
      summary: Spot bitcoin ETF creation/redemption flows (pay per call, x402)
      description: Always answers 402 until an x402 v2 payment is attached (PAYMENT-SIGNATURE header). Price 0.005 USDC per call on eip155:8453,eip155:42161. Live data, up to 5000 records.
      tags:
      - X402
      x-price-usdc: '0.005'
      x-x402:
        version: 2
        scheme: exact
        network: eip155:8453,eip155:42161
        enabled: true
      parameters:
      - name: ticker
        in: query
        required: false
        schema:
          type: string
        description: Fund ticker, e.g. IBIT
      - name: tickers
        in: query
        required: false
        schema:
          type: string
        description: Comma-separated fund tickers
      - name: since
        in: query
        required: false
        schema:
          type: string
        description: Only rows on/after this YYYY-MM-DD
      - name: PAYMENT-SIGNATURE
        in: header
        required: false
        schema:
          type: string
        description: base64 JSON x402 v2 PaymentPayload
      responses:
        '200':
          description: Paid feed envelope
          headers:
            PAYMENT-RESPONSE:
              schema:
                type: string
              description: base64 JSON x402 SettlementResponse (transaction, network, payer)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedEnvelope'
        '402':
          description: 'Payment required (or payment rejected: see error/code)'
          headers:
            PAYMENT-REQUIRED:
              schema:
                type: string
              description: base64 JSON x402 v2 PaymentRequired — identical to the body
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '503':
          description: pay-per-call not enabled on this deployment
  /paid/feed/insider_buys:
    get:
      operationId: paid_insider_buys
      summary: SEC Form 4 open-market insider BUYS + Schedule 13D/13G stake increases (pay per…
      description: Always answers 402 until an x402 v2 payment is attached (PAYMENT-SIGNATURE header). Price 0.005 USDC per call on eip155:8453,eip155:42161. Live data, up to 5000 records.
      tags:
      - X402
      x-price-usdc: '0.005'
      x-x402:
        version: 2
        scheme: exact
        network: eip155:8453,eip155:42161
        enabled: true
      parameters:
      - name: ticker
        in: query
        required: false
        schema:
          type: string
      - name: tickers
        in: query
        required: false
        schema:
          type: string
        description: Comma-separated tickers (max 100)
      - name: min_value
        in: query
        required: false
        schema:
          type: number
        description: Minimum transaction value in USD (Form 4 rows only carry a value)
      - name: since
        in: query
        required: false
        schema:
          type: string
        description: Only transactions on/after this YYYY-MM-DD
      - name: form
        in: query
        required: false
        schema:
          type: string
          enum:
          - '4'
          - 13D
          - 13G
        description: SEC form; omit for all
      - name: PAYMENT-SIGNATURE
        in: header
        required: false
        schema:
          type: string
        description: base64 JSON x402 v2 PaymentPayload
      responses:
        '200':
          description: Paid feed envelope
          headers:
            PAYMENT-RESPONSE:
              schema:
                type: string
              description: base64 JSON x402 SettlementResponse (transaction, network, payer)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedEnvelope'
        '402':
          description: 'Payment required (or payment rejected: see error/code)'
          headers:
            PAYMENT-REQUIRED:
              schema:
                type: string
              description: base64 JSON x402 v2 PaymentRequired — identical to the body
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '503':
          description: pay-per-call not enabled on this deployment
  /paid/feed/insider_sells:
    get:
      operationId: paid_insider_sells
      summary: SEC Form 4 open-market insider SELLS + Schedule 13D/13G stake decreases (pay…
      description: Always answers 402 until an x402 v2 payment is attached (PAYMENT-SIGNATURE header). Price 0.005 USDC per call on eip155:8453,eip155:42161. Live data, up to 5000 records.
      tags:
      - X402
      x-price-usdc: '0.005'
      x-x402:
        version: 2
        scheme: exact
        network: eip155:8453,eip155:42161
        enabled: true
      parameters:
      - name: ticker
        in: query
        required: false
        schema:
          type: string
      - name: tickers
        in: query
        required: false
        schema:
          type: string
        description: Comma-separated tickers (max 100)
      - name: min_value
        in: query
        required: false
        schema:
          type: number
        description: Minimum transaction value in USD (Form 4 rows only carry a value)
      - name: since
        in: query
        required: false
        schema:
          type: string
        description: Only transactions on/after this YYYY-MM-DD
      - name: form
        in: query
        required: false
        schema:
          type: string
          enum:
          - '4'
          - 13D
          - 13G
        description: SEC form; omit for all
      - name: PAYMENT-SIGNATURE
        in: header
        required: false
        schema:
          type: string
        description: base64 JSON x402 v2 PaymentPayload
      responses:
        '200':
          description: Paid feed envelope
          headers:
            PAYMENT-RESPONSE:
              schema:
                type: string
              description: base64 JSON x402 SettlementResponse (transaction, network, payer)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedEnvelope'
        '402':
          description: 'Payment required (or payment rejected: see error/code)'
          headers:
            PAYMENT-REQUIRED:
              schema:
                type: string
              description: base64 JSON x402 v2 PaymentRequired — identical to the body
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '503':
          description: pay-per-call not enabled on this deployment
  /paid/feed/launch_ledger:
    get:
      operationId: paid_launch_ledger
      summary: 'Robinhood Chain token launches: early-buyer cohorts, graded at 24h/7d (pay per…'
      description: Always answers 402 until an x402 v2 payment is attached (PAYMENT-SIGNATURE header). Price 0.005 USDC per call on eip155:8453,eip155:42161. Live data, up to 5000 records.
      tags:
      - X402
      x-price-usdc: '0.005'
      x-x402:
        version: 2
        scheme: exact
        network: eip155:8453,eip155:42161
        enabled: true
      parameters:
      - name: ticker
        in: query
        required: false
        schema:
          type: string
        description: Token symbol as the deployer named it (untrusted text)
      - name: tickers
        in: query
        required: false
        schema:
          type: string
        description: Comma-separated token symbols
      - name: launchpad
        in: query
        required: false
        schema:
          type: string
        description: Substring match, e.g. doppler, launchhook, none
      - name: quote
        in: query
        required: false
        schema:
          type: string
        description: 'Quote asset: ETH, WETH, USDG, or a stock token symbol'
      - name: wallet
        in: query
        required: false
        schema:
          type: string
        description: Launches this address was early in, or deployed
      - name: min_buyers
        in: query
        required: false
        schema:
          type: number
        description: Minimum distinct early buyers captured
      - name: min_usd
        in: query
        required: false
        schema:
          type: number
        description: Minimum first-hour buy volume, USD estimate
      - name: since
        in: query
        required: false
        schema:
          type: string
        description: Only launches on/after this YYYY-MM-DD
      - name: PAYMENT-SIGNATURE
        in: header
        required: false
        schema:
          type: string
        description: base64 JSON x402 v2 PaymentPayload
      responses:
        '200':
          description: Paid feed envelope
          headers:
            PAYMENT-RESPONSE:
              schema:
                type: string
              description: base64 JSON x402 SettlementResponse (transaction, network, payer)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedEnvelope'
        '402':
          description: 'Payment required (or payment rejected: see error/code)'
          headers:
            PAYMENT-REQUIRED:
              schema:
                type: string
              description: base64 JSON x402 v2 PaymentRequired — identical to the body
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '503':
          description: pay-per-call not enabled on this deployment
  /paid/feed/launch_wallets:
    get:
      operationId: paid_launch_wallets
      summary: Robinhood Chain early-buyer wallet book (repeat rate, hit rate, deployer…
      description: Always answers 402 until an x402 v2 payment is attached (PAYMENT-SIGNATURE header). Price 0.005 USDC per call on eip155:8453,eip155:42161. Live data, up to 5000 records.
      tags:
      - X402
      x-price-usdc: '0.005'
      x-x402:
        version: 2
        scheme: exact
        network: eip155:8453,eip155:42161
        enabled: true
      parameters:
      - name: wallet
        in: query
        required: false
        schema:
          type: string
        description: One address
      - name: ticker
        in: query
        required: false
        schema:
          type: string
        description: Wallets that were early in this token symbol
      - name: launchpad
        in: query
        required: false
        schema:
          type: string
        description: Wallets active on this launchpad
      - name: min_launches
        in: query
        required: false
        schema:
          type: number
        description: Minimum launches early in
      - name: since
        in: query
        required: false
        schema:
          type: string
        description: Wallets last seen on/after this YYYY-MM-DD
      - name: PAYMENT-SIGNATURE
        in: header
        required: false
        schema:
          type: string
        description: base64 JSON x402 v2 PaymentPayload
      responses:
        '200':
          description: Paid feed envelope
          headers:
            PAYMENT-RESPONSE:
              schema:
                type: string
              description: base64 JSON x402 SettlementResponse (transaction, network, payer)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedEnvelope'
        '402':
          description: 'Payment required (or payment rejected: see error/code)'
          headers:
            PAYMENT-REQUIRED:
              schema:
                type: string
              description: base64 JSON x402 v2 PaymentRequired — identical to the body
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '503':
          description: pay-per-call not enabled on this deployment
  /paid/feed/options_iv:
    get:
      operationId: paid_options_iv
      summary: 'Daily option-chain structure per ticker: ATM IV, IV rank, term, skew, put/call…'
      description: Always answers 402 until an x402 v2 payment is attached (PAYMENT-SIGNATURE header). Price 0.02 USDC per call on eip155:8453,eip155:42161. Live data, up to 5000 records.
      tags:
      - X402
      x-price-usdc: '0.02'
      x-x402:
        version: 2
        scheme: exact
        network: eip155:8453,eip155:42161
        enabled: true
      parameters:
      - name: ticker
        in: query
        required: false
        schema:
          type: string
        description: One ticker, e.g. NVDA
      - name: tickers
        in: query
        required: false
        schema:
          type: string
        description: Comma-separated tickers (max 100)
      - name: since
        in: query
        required: false
        schema:
          type: string
        description: Only trading days on/after this YYYY-MM-DD
      - name: min_iv_rank
        in: query
        required: false
        schema:
          type: number
        description: Minimum iv_rank, 0-1 (e.g. 0.9 = vol rich)
      - name: max_iv_rank
        in: query
        required: false
        schema:
          type: number
        description: Maximum iv_rank, 0-1 (e.g. 0.1 = vol cheap)
      - name: lean
        in: query
        required: false
        schema:
          type: string
          enum:
          - call
          - put
          - mixed
        description: Unusual-activity lean on the day
      - name: min_hist_days
        in: query
        required: false
        schema:
          type: number
        description: Only rows whose iv_rank rests on at least this many days of history
      - name: PAYMENT-SIGNATURE
        in: header
        required: false
        schema:
          type: string
        description: base64 JSON x402 v2 PaymentPayload
      responses:
        '200':
          description: Paid feed envelope
          headers:
            PAYMENT-RESPONSE:
              schema:
                type: string
              description: base64 JSON x402 SettlementResponse (transaction, network, payer)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedEnvelope'
        '402':
          description: 'Payment required (or payment rejected: see error/code)'
          headers:
            PAYMENT-REQUIRED:
              schema:
                type: string
              description: base64 JSON x402 v2 PaymentRequired — identical to the body
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '503':
          description: pay-per-call not enabled on this deployment
  /.well-known/x402.json:
    get:
      operationId: x402_manifest
      summary: 'x402 discovery manifest: every paid resource with its PaymentRequirements and…'
      tags:
      - X402
      responses:
        '200':
          description: OK
components:
  schemas:
    PaymentRequired:
      type: object
      required:
      - x402Version
      - resource
      - accepts
      properties:
        x402Version:
          type: integer
          const: 2
        error:
          type: string
        code:
          type: string
          description: machine-readable rejection reason when a payment was attached but not accepted
        resource:
          type: object
          properties:
            url:
              type: string
            description:
              type: string
            mimeType:
              type: string
        accepts:
          type: array
          items:
            type: object
            properties:
              scheme:
                type: string
              network:
                type: string
              amount:
                type: string
              asset:
                type: string
              payTo:
                type: string
              maxTimeoutSeconds:
                type: integer
              extra:
                type: object
        extensions:
          type: object
    FeedEnvelope:
      type: object
      required:
      - feed
      - tier
      - records
      properties:
        feed:
          type: string
        generated_at:
          type: string
        snapshot_sha256:
          type:
          - string
          - 'null'
        anchored_at:
          type:
          - string
          - 'null'
        source:
          type: string
        rights:
          type: string
        provenance_note:
          type: string
        notes:
          type: array
          items:
            type: string
        forms_recorded:
          type: array
          items:
            type: string
        tier:
          $ref: '#/components/schemas/Tier'
        records:
          type: array
          items:
            type: object
            properties:
              happened_at:
                type:
                - string
                - 'null'
                description: when the event occurred, per the source
              observed_at:
                type:
                - string
                - 'null'
                description: when this pipeline first saw the record
              provenance:
                type: string
                enum:
                - observed
                - pre-existing
            additionalProperties: true
    Tier:
      type: object
      properties:
        name:
          type: string
          enum:
          - free
          - token
          - x402
        total_in_feed:
          type: integer
        matched_filters:
          type: integer
        returned:
          type: integer
        withheld_for_freshness:
          type: integer
        truncated_by_cap:
          type: integer
        upgrade:
          type: string
        auth:
          type: string
          enum:
          - degraded