Deep Blue Alpha API

openapi: 3.1.0
info:
  title: Deep Blue Alpha API
  version: '2026-11-05'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-05: 13 operation(s) read from 5 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Deep Blue Alpha has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 6
    documentation: 7
    pages-with-code: 4
    pages-read: 5
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-05'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://deepbluealpha.io/whale-api
  - https://deepbluealpha.io/compare/vs-whale-alert-api
  - https://deepbluealpha.io/research/ethereum-exchange-flow-data-api
  - https://deepbluealpha.io/api-docs
  - https://deepbluealpha.io/api-docs/webhooks
paths:
  /api/backtest/run:
    post:
      operationId: post_api_backtest_run
      tags:
      - Api
      summary: POST /api/backtest/run
      x-source: https://deepbluealpha.io/api-docs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiBacktestRunRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST -H \"X-API-Key: dba_YOUR_KEY\" -H \"Content-Type: application/json\"  -d '{\"start\":\"2026-08-01\",\"end\":\"\
          2026-09-30\",\"signal_types\":[]}'  https://deepbluealpha.io/api/backtest/run \n start , end (required): YYYY-MM-DD or an ISO datetime.\
          \ end must be after start , not in the future, and at most 365 days later. \n signal_types (optional): a list of signal type names;\
          \ empty or missing runs every"
  /api/v1/signals:
    get:
      operationId: get_api_v1_signals
      tags:
      - Api
      summary: Every Deep Blue Alpha whale signal since April 2026 with 1/7/30‑day % change and ETH over the same window, graded on closing prices.
      x-source: https://deepbluealpha.io/api-docs
      parameters:
      - name: start
        in: query
        required: false
        schema:
          type: string
        description: Start date (YYYY‑MM‑DD).
      - name: end
        in: query
        required: false
        schema:
          type: string
        description: End date (YYYY‑MM‑DD).
      - name: graded_only
        in: query
        required: false
        schema:
          type: boolean
        description: Only rows with a 7‑day result.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Maximum rows per page.
      - name: after_id
        in: query
        required: false
        schema:
          type: string
        description: Cursor for pagination.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1SignalsResponse'
      x-evidence:
        kind: documentation
  /api/v1/signals/summary:
    get:
      operationId: get_api_v1_signals_summary
      tags:
      - Api
      summary: 'Per signal type and overall summary: counts, hit rate, verdicts, averages, and share beating ETH.'
      x-source: https://deepbluealpha.io/api-docs
      parameters:
      - name: start
        in: query
        required: false
        schema:
          type: string
        description: Start date (YYYY‑MM‑DD).
      - name: end
        in: query
        required: false
        schema:
          type: string
        description: End date (YYYY‑MM‑DD).
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1SignalsSummaryResponse'
      x-evidence:
        kind: documentation
  /api/v1/token/{symbol}/flow:
    get:
      operationId: get_api_v1_token_symbol_flow
      tags:
      - Api
      summary: 'Single-token whale flow over 24h / 7d / 30d: net flow, accumulation/distribution volume, moves, distinct wallets.'
      x-source: https://deepbluealpha.io/whale-api
      parameters:
      - name: symbol
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1TokenSymbolFlowResponse'
      x-evidence:
        kind: documentation
  /api/v1/top-tokens:
    get:
      operationId: get_api_v1_top_tokens
      tags:
      - Api
      summary: GET /api/v1/top-tokens
      x-source: https://deepbluealpha.io/whale-api
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
      - name: tf
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1TopTokensResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -H \"X-API-Key: dba_your_key_here\"  \"https://deepbluealpha.io/api/v1/top-tokens?tf=24H&limit=10\" \n Python \n import\
          \ requests\nAPI_KEY = \"dba_your_key_here\"\nBASE = \"https://deepbluealpha.io/api/v1\""
  /api/v1/top-wallets:
    get:
      operationId: get_api_v1_top_wallets
      tags:
      - Api
      summary: Whale wallet leaderboard — address, tracked volume, rank, label.
      x-source: https://deepbluealpha.io/whale-api
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Maximum number of wallets to return.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1TopWalletsResponse'
      x-evidence:
        kind: documentation
  /api/v1/transactions:
    get:
      operationId: get_api_v1_transactions
      tags:
      - Api
      summary: Recent whale transactions, newest first. Paginate with before_id.
      x-source: https://deepbluealpha.io/whale-api
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Maximum number of transactions to return.
      - name: before_id
        in: query
        required: false
        schema:
          type: string
        description: Cursor for pagination (transactions older than this ID).
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1TransactionsResponse'
      x-evidence:
        kind: documentation
  /api/v1/watchlist:
    get:
      operationId: get_api_v1_watchlist
      tags:
      - Api
      summary: Your saved watchlist (wallets + tokens) with 7‑day net flow and move counts per item.
      x-source: https://deepbluealpha.io/whale-api
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1WatchlistResponse'
      x-evidence:
        kind: documentation
  /api/v1/whale-index:
    get:
      operationId: get_api_v1_whale_index
      tags:
      - Api
      summary: GET /api/v1/whale-index
      x-source: https://deepbluealpha.io/whale-api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -H \"X-API-Key: dba_your_key_here\"  https://deepbluealpha.io/api/v1/whale-index \n Error codes: 401 (missing or invalid\
          \ key), 403 (tier below Whale), 429 (daily rate limit reached — resets at UTC midnight). Full technical documentation: API reference\
          \ → \n Start building on whale data \n Whale tier — $79.99/mo. 25,000 API calls/day. Full dashboard included. \n Get API access → \n\
          \ Read the API docume"
  /data/files:
    get:
      operationId: get_data_files
      tags:
      - Data
      summary: Download list of daily data files (CSV/JSONL) for whale moves.
      x-source: https://deepbluealpha.io/api-docs
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetDataFilesResponse'
      x-evidence:
        kind: documentation
  /data/files/dba_whale_moves_2026-10-15.csv.gz:
    get:
      operationId: get_data_files_dba_whale_moves_2026_10_15_csv_gz
      tags:
      - Data
      summary: Daily file of every whale move for 2026‑10‑15 in CSV format.
      x-source: https://deepbluealpha.io/api-docs
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetDataFilesDbaWhaleMoves20261015CsvGzResponse'
      x-evidence:
        kind: documentation
  /dba-webhook:
    post:
      operationId: post_dba_webhook
      tags:
      - Dba Webhook
      summary: POST /dba-webhook
      x-source: https://deepbluealpha.io/api-docs/webhooks
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -s -X POST http://localhost:8000/dba-webhook  -H \"Content-Type: application/json\"  -H \"X-DBA-Signature: t=$TS,v1=$SIG\"\
          \ -d \"$BODY\" \n Python example "
  /v1/transactions:
    get:
      operationId: get_v1_transactions
      tags:
      - Transactions
      summary: GET /v1/transactions
      x-source: https://deepbluealpha.io/compare/vs-whale-alert-api
      parameters:
      - name: api_key
        in: query
        required: false
        schema:
          type: string
      - name: min_value
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1TransactionsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl "https://api.whale-alert.io/v1/transactions?api_key=YOUR_KEY&min_value=500000" '
components:
  schemas:
    PostApiBacktestRunRequest:
      type: object
      properties:
        start:
          type: string
          format: date
        end:
          type: string
          format: date
        signal_types:
          type: array
          items: {}
    GetApiV1SignalsResponse:
      type: object
      properties:
        data:
          type: object
          description: Array of signal rows.
        meta:
          type: object
          description: Metadata.
    GetApiV1SignalsSummaryResponse:
      type: object
      properties:
        data:
          type: object
          description: Summary statistics.
        meta:
          type: object
          description: Metadata.
    GetApiV1TokenSymbolFlowResponse:
      type: object
      properties:
        data:
          type: object
          description: Flow data for the specified token.
        meta:
          type: object
          description: Metadata including tier, endpoint, generated_at.
    GetApiV1TopTokensResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            timeframe:
              type: string
            tokens:
              type: array
              items:
                type: object
                properties:
                  symbol:
                    type: string
                  net_flow_usd:
                    type: number
                  buy_volume_usd:
                    type: number
                  sell_volume_usd:
                    type: number
                  trades:
                    type: integer
        meta:
          type: object
          properties:
            tier:
              type: string
            endpoint:
              type: string
            generated_at:
              type: string
              format: date-time
    GetApiV1TopWalletsResponse:
      type: object
      properties:
        data:
          type: object
          description: Leaderboard data (implementation‑specific).
        meta:
          type: object
          description: Metadata including tier, endpoint, generated_at.
    GetApiV1TransactionsResponse:
      type: object
      properties:
        data:
          type: object
          description: List of recent transactions.
        meta:
          type: object
          description: Metadata including tier, endpoint, generated_at.
    GetApiV1WatchlistResponse:
      type: object
      properties:
        data:
          type: object
          description: Watchlist items with flow and move counts.
        meta:
          type: object
          description: Metadata including tier, endpoint, generated_at.
    GetDataFilesResponse:
      type: object
      properties:
        files:
          type: array
          description: List of file URLs.
    GetDataFilesDbaWhaleMoves20261015CsvGzResponse:
      type: object
      properties:
        file:
          type: string
          description: Compressed CSV of whale moves.
    GetV1TransactionsResponse:
      type: object
      properties:
        result:
          type: string
        transactions:
          type: array
          items:
            type: object
            properties:
              blockchain:
                type: string
              hash:
                type: string
              amount:
                type: integer
              amount_usd:
                type: integer
              from:
                type: object
                properties:
                  address:
                    type: string
                  owner:
                    type: string
              to:
                type: object
                properties:
                  address:
                    type: string
                  owner:
                    type: string
              timestamp:
                type: integer
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
security:
- apiKey: []
tags:
- name: Api
- name: Data
- name: Dba Webhook
- name: Transactions