distillmarkets-com

distillmarkets-com API

distillmarkets-com API as documented publicly: 20 operations. Contract generated from the documentation by API Evangelist (2026-10-30); not the provider's own document.

Documentation GitHub OpenAPI

Operations 20

GET / GET / #

GET /api/public/delisted GET /api/public/delisted #

GET /api/v1/anonymous/asof GET /api/v1/anonymous/asof #

GET /api/v1/benchmark GET /api/v1/benchmark #

GET /api/v1/benchmark/history GET /api/v1/benchmark/history #

GET /api/v1/benchmark/tickers/AAPL GET /api/v1/benchmark/tickers/AAPL #

GET /api/v1/macro GET /api/v1/macro #

GET /api/v1/sec/facts/AAPL Raw XBRL facts for one concept (Analyst tier) #

GET /api/v1/sec/filings/AAPL GET /api/v1/sec/filings/AAPL #

GET /api/v1/sec/financial-health/{financialhealthid} Leverage, liquidity, margin and return ratios. #

GET /api/v1/sec/fundamentals/KHC/as-of/2019-01-31 Fetch fundamentals as knowable on a past date #

GET /api/v1/sec/fundamentals/{fundamentalid} GET /api/v1/sec/fundamentals/AAME #

GET /api/v1/sec/fundamentals/{fundamentalid}/as-of/YYYY-MM-DD The same figures as they were known on any past date. #

GET /api/v1/sec/fundamentals/{fundamentalid}/history Fiscal-year trajectory: revenue, margins, free cash flow. #

GET /api/v1/sec/managers/vanguard What a manager holds. #

GET /api/v1/sec/ownership/AAPL GET /api/v1/sec/ownership/AAPL #

GET /api/v1/sec/ownership/AAPL/blockholders Schedule 13D and 13G filings that disclose stakes above 5%. #

GET /api/v1/sec/pre2009/screen Screen the whole pre-2009 cohort, delisted companies included (Pro). #

GET /api/v1/sec/revisions/KHC GET /api/v1/sec/revisions/KHC #

POST /api/v1/sec/screen Start with POST /api/v1/sec/screen. #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/distillmarkets-com/openapi/_ae-authored/distillmarkets-com-openapi-generated.yml

Schemas & Data

📊

JSONSchema

https://artifacts.apis.io/distillmarkets-com/json-schema/distillmarkets-com-get-api-v1-sec-fundamentals-fundamentalid-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/distillmarkets-com/json-schema/distillmarkets-com-get-api-v1-anonymous-asof-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/distillmarkets-com/json-schema/distillmarkets-com-get-api-v1-sec-managers-vanguard-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/distillmarkets-com/json-schema/distillmarkets-com-get-api-v1-sec-filings-aapl-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/distillmarkets-com/json-schema/distillmarkets-com-get-api-v1-sec-fundamentals-khc-as-of20190131-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/distillmarkets-com/json-schema/distillmarkets-com-get-api-v1-sec-facts-aapl-response-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/distillmarkets-com:distillmarkets-com-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: distillmarkets-com API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 20 operation(s) read from 40 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; distillmarkets-com has published no machine-readable
    contract that the pipeline could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 42
    documentation: -22
    pages-with-code: 40
    pages-read: 40
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://www.distillmarkets.com/13f-api
  - https://www.distillmarkets.com/xbrl-api
  - https://www.distillmarkets.com/sec-filings-api
  - https://www.distillmarkets.com/restatements-api
  - https://www.distillmarkets.com/docs
  - https://www.distillmarkets.com/developer/start
  - https://www.distillmarkets.com/benchmark
  - https://www.distillmarkets.com/delisted
  - https://www.distillmarkets.com/point-in-time-fundamentals
  - https://www.distillmarkets.com/company/GLTK
  - https://www.distillmarkets.com/company/WBSR
  - https://www.distillmarkets.com/company/AAME
  - https://www.distillmarkets.com/company/GPRO
  - https://www.distillmarkets.com/company/CMTL
  - https://www.distillmarkets.com/company/EVOH
  - https://www.distillmarkets.com/company/EONR
  - https://www.distillmarkets.com/company/CVAT
  - https://www.distillmarkets.com/company/IPW
  - https://www.distillmarkets.com/company/LRDC
  - https://www.distillmarkets.com/company/GURE
  - https://www.distillmarkets.com/company/LUVU
  - https://www.distillmarkets.com/company/VIPZ
  - https://www.distillmarkets.com/company/POCI
  - https://www.distillmarkets.com/company/SGLA
  - https://www.distillmarkets.com/company/MKZR
  - https://www.distillmarkets.com/company/GGRP
  - https://www.distillmarkets.com/company/ZRCN
  - https://www.distillmarkets.com/company/NIOBW
  - https://www.distillmarkets.com/company/CSUI
  - https://www.distillmarkets.com/company/IXHL
  - https://www.distillmarkets.com/company/LSH
  - https://www.distillmarkets.com/company/RAVE
  - https://www.distillmarkets.com/company/TRT
  - https://www.distillmarkets.com/company/SCTH
  - https://www.distillmarkets.com/company/ANAB
  - https://www.distillmarkets.com/company/YYAI
  - https://www.distillmarkets.com/company/MGLD
  - https://www.distillmarkets.com/company/WSBK
  - https://www.distillmarkets.com/company/TMGI
  - https://www.distillmarkets.com/company/HIGR
servers:
- url: https://api.distillmarkets.com
paths:
  /:
    get:
      operationId: get
      tags:
      - Api
      summary: GET /
      x-source: https://www.distillmarkets.com/developer/start
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl and Python 01 Add the connector In claude.ai, open Settings , then Connectors , and choose Add custom connector . Name
          it Distill Markets and give it the server URL. Claude Desktop has the same screen under Settings. server URL Copy https://mcp.distillmarkets.com
          02 Sign in once Claude opens the Distill Markets consent screen. Sign in, or create a free account right there. There is no key to '
  /api/public/delisted:
    get:
      operationId: get_api_public_delisted
      tags:
      - Api
      summary: GET /api/public/delisted
      x-source: https://www.distillmarkets.com/delisted
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl Copy curl -H "X-Api-Key: $DISTILL_API_KEY" \ https://api.distillmarkets.com/api/public/delisted Screen the whole pre-2009
          cohort, delisted companies included (Pro) curl Copy curl -H "X-Api-Key: $DISTILL_API_KEY" \ https://api.distillmarkets.com/api/v1/sec/pre2009/screen
          MCP tool: screen_pre2009 min_revenue=100000000 fiscal_year=2008 The years are not evenly covered, and the thin ones are our '
  /api/v1/anonymous/asof:
    get:
      operationId: get_api_v1_anonymous_asof
      tags:
      - Api
      summary: GET /api/v1/anonymous/asof
      x-source: https://www.distillmarkets.com/point-in-time-fundamentals
      parameters:
      - name: date
        in: query
        required: false
        schema:
          type: string
      - name: ticker
        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/GetApiV1AnonymousAsofResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl Copy # No key: allowlisted tickers, ten reads an hour per address curl -s "https://api.distillmarkets.com/api/v1/anonymous/asof?ticker=KHC&date=2019-01-31"
            # With a key: any covered ticker, annual or quarterly basis curl -s "https://api.distillmarkets.com/api/v1/sec/fundamentals/KHC/as-of/2019-01-31"
          \ -H "X-Api-Key: $DISTILL_API_KEY" python (requests) Copy import requests   BASE = "https:/'
  /api/v1/benchmark:
    get:
      operationId: get_api_v1_benchmark
      tags:
      - Api
      summary: GET /api/v1/benchmark
      x-source: https://www.distillmarkets.com/benchmark
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl https://api.distillmarkets.com/api/v1/benchmark # latest run, every cell'
  /api/v1/benchmark/history:
    get:
      operationId: get_api_v1_benchmark_history
      tags:
      - Api
      summary: GET /api/v1/benchmark/history
      x-source: https://www.distillmarkets.com/benchmark
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl https://api.distillmarkets.com/api/v1/benchmark/history # trailing runs'
  /api/v1/benchmark/tickers/AAPL:
    get:
      operationId: get_api_v1_benchmark_tickers_AAPL
      tags:
      - Api
      summary: GET /api/v1/benchmark/tickers/AAPL
      x-source: https://www.distillmarkets.com/benchmark
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl https://api.distillmarkets.com/api/v1/benchmark/tickers/AAPL Methodology version v3-2026-10-05 . Use this data in your
          own app The same endpoint that produced these results is on the free tier. 150 calls/day, no credit card, full ticker universe. curl
          -H "X-Api-Key: $YOUR_KEY"  https://api.distillmarkets.com/api/v1/sec/fundamentals/AAPL Get a free API key See all plans → Distill Markets
          is no'
  /api/v1/macro:
    get:
      operationId: get_api_v1_macro
      tags:
      - Api
      summary: GET /api/v1/macro
      x-source: https://www.distillmarkets.com/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl Copy curl https://api.distillmarkets.com/api/v1/macro \ -H "X-Api-Key: dmk_your_key_here" Tip Start with POST /api/v1/sec/screen
          . A free key screens the whole SEC universe by margins, leverage, R&D, working capital, capex, buybacks and more. The four scored metrics
          (Altman Z, Piotroski, accruals, M-score) need quality:read (Analyst) and are null on Free. Run any documented call against your '
  /api/v1/sec/facts/AAPL:
    get:
      operationId: get_api_v1_sec_facts_AAPL
      tags:
      - Api
      summary: Raw XBRL facts for one concept (Analyst tier)
      x-source: https://www.distillmarkets.com/xbrl-api
      parameters:
      - name: concept
        in: query
        required: false
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1SecFactsAaplResponse'
      x-evidence:
        kind: documentation
  /api/v1/sec/filings/AAPL:
    get:
      operationId: get_api_v1_sec_filings_AAPL
      tags:
      - Api
      summary: GET /api/v1/sec/filings/AAPL
      x-source: https://www.distillmarkets.com/sec-filings-api
      parameters:
      - name: filingType
        in: query
        required: false
        schema:
          type: string
      - name: limit
        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/GetApiV1SecFilingsAaplResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl Copy curl -s "https://api.distillmarkets.com/api/v1/sec/filings/AAPL?filingType=10-K&limit=3" \ -H "X-Api-Key: $DISTILL_API_KEY"
          python (requests) Copy import os import requests   HEADERS = { "X-Api-Key" : os.environ[ "DISTILL_API_KEY" ]} BASE = "https://api.distillmarkets.com"
            r = requests.get( f "{BASE}/api/v1/sec/filings/AAPL" , params={ "filingType" : "10-K" , "limit" : 3}, headers=HEAD'
  /api/v1/sec/financial-health/{financialhealthid}:
    get:
      operationId: get_api_v1_sec_financial_health_financialhealthid
      tags:
      - Api
      summary: Leverage, liquidity, margin and return ratios.
      x-source: https://www.distillmarkets.com/company/AAME
      parameters:
      - name: financialhealthid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
        collapsed_from: 31 example path(s) differing only at financialhealthId
  /api/v1/sec/fundamentals/KHC/as-of/2019-01-31:
    get:
      operationId: get_api_v1_sec_fundamentals_KHC_as_of_2019_01_31
      tags:
      - Api
      summary: Fetch fundamentals as knowable on a past date
      x-source: https://www.distillmarkets.com/point-in-time-fundamentals
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1SecFundamentalsKhcAsOf20190131Response'
      x-evidence:
        kind: documentation
  /api/v1/sec/fundamentals/{fundamentalid}:
    get:
      operationId: get_api_v1_sec_fundamentals_fundamentalid
      tags:
      - Api
      summary: GET /api/v1/sec/fundamentals/AAME
      x-source: https://www.distillmarkets.com/company/AAME
      parameters:
      - name: fundamentalid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1SecFundamentalsFundamentalidResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl Copy curl -H "X-Api-Key: $DISTILL_API_KEY" \ https://api.distillmarkets.com/api/v1/sec/fundamentals/AAME MCP tool: get_sec_fundamentals
          ticker=AAME The same figures as they were known on any past date curl Copy curl -H "X-Api-Key: $DISTILL_API_KEY" \ https://api.distillmarkets.com/api/v1/sec/fundamentals/AAME/as-of/YYYY-MM-DD
          MCP tool: get_asof_fundamentals ticker=AAME as_of=YYYY-MM-DD Fiscal'
        collapsed_from: 32 example path(s) differing only at fundamentalId
  /api/v1/sec/fundamentals/{fundamentalid}/as-of/YYYY-MM-DD:
    get:
      operationId: get_api_v1_sec_fundamentals_fundamentalid_as_of_YYYY_MM_DD
      tags:
      - Api
      summary: The same figures as they were known on any past date.
      x-source: https://www.distillmarkets.com/company/AAME
      parameters:
      - name: fundamentalid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
        collapsed_from: 31 example path(s) differing only at fundamentalId
  /api/v1/sec/fundamentals/{fundamentalid}/history:
    get:
      operationId: get_api_v1_sec_fundamentals_fundamentalid_history
      tags:
      - Api
      summary: 'Fiscal-year trajectory: revenue, margins, free cash flow.'
      x-source: https://www.distillmarkets.com/company/AAME
      parameters:
      - name: fundamentalid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
        collapsed_from: 31 example path(s) differing only at fundamentalId
  /api/v1/sec/managers/vanguard:
    get:
      operationId: get_api_v1_sec_managers_vanguard
      tags:
      - Api
      summary: What a manager holds.
      x-source: https://www.distillmarkets.com/13f-api
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: number
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1SecManagersVanguardResponse'
      x-evidence:
        kind: documentation
  /api/v1/sec/ownership/AAPL:
    get:
      operationId: get_api_v1_sec_ownership_AAPL
      tags:
      - Api
      summary: GET /api/v1/sec/ownership/AAPL
      x-source: https://www.distillmarkets.com/13f-api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl Copy curl -s "https://api.distillmarkets.com/api/v1/sec/ownership/AAPL" \ -H "X-Api-Key: $DISTILL_API_KEY"   curl -s "https://api.distillmarkets.com/api/v1/sec/managers/vanguard?limit=3"
          \ -H "X-Api-Key: $DISTILL_API_KEY"   curl -s "https://api.distillmarkets.com/api/v1/sec/ownership/AAPL/blockholders" \ -H "X-Api-Key:
          $DISTILL_API_KEY" python (requests) Copy import os import requests   HEADE'
  /api/v1/sec/ownership/AAPL/blockholders:
    get:
      operationId: get_api_v1_sec_ownership_AAPL_blockholders
      tags:
      - Api
      summary: Schedule 13D and 13G filings that disclose stakes above 5%.
      x-source: https://www.distillmarkets.com/13f-api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/sec/pre2009/screen:
    get:
      operationId: get_api_v1_sec_pre2009_screen
      tags:
      - Api
      summary: Screen the whole pre-2009 cohort, delisted companies included (Pro).
      x-source: https://www.distillmarkets.com/delisted
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/sec/revisions/KHC:
    get:
      operationId: get_api_v1_sec_revisions_KHC
      tags:
      - Api
      summary: GET /api/v1/sec/revisions/KHC
      x-source: https://www.distillmarkets.com/restatements-api
      parameters:
      - name: minDelta
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl Copy curl -s "https://api.distillmarkets.com/api/v1/sec/revisions/KHC?minDelta=0.05" \ -H "X-Api-Key: $DISTILL_API_KEY"
          python (requests) Copy import os import requests   HEADERS = { "X-Api-Key" : os.environ[ "DISTILL_API_KEY" ]} BASE = "https://api.distillmarkets.com"
            r = requests.get( f "{BASE}/api/v1/sec/revisions/KHC" , params={ "minDelta" : 0.05}, headers=HEADERS, timeout=30, ) r.raise'
  /api/v1/sec/screen:
    post:
      operationId: post_api_v1_sec_screen
      tags:
      - Api
      summary: Start with POST /api/v1/sec/screen.
      x-source: https://www.distillmarkets.com/docs
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiV1AnonymousAsofResponse:
      type: object
      properties:
        ticker:
          type: string
        companyName:
          type: string
        asOf:
          type: string
          format: date
        periodEnd:
          type: string
          format: date
        delistedAt:
          type:
          - string
          - 'null'
        values:
          type: array
          items:
            type: object
            properties:
              conceptGroup:
                type: string
              value:
                type: number
              filedAt:
                type: string
                format: date
              accessionNumber:
                type: string
    GetApiV1SecFactsAaplResponse:
      type: object
      properties:
        concept:
          type: string
        value:
          type: number
        unit:
          type: string
        form:
          type: string
        fiscal year:
          type: string
    GetApiV1SecFilingsAaplResponse:
      type: object
      properties:
        ticker:
          type: string
        filingType:
          type: string
        formDescription:
          type: string
        filedAt:
          type: string
        accessionNumber:
          type: string
        cikNumber:
          type: string
        url:
          type: string
        items:
          type: array
          items:
            type: string
    GetApiV1SecFundamentalsKhcAsOf20190131Response:
      type: object
      properties:
        ticker:
          type: string
        companyName:
          type: string
        asOf:
          type: string
        periodEnd:
          type: string
        delistedAt:
          type: string
        values:
          type: array
    GetApiV1SecFundamentalsFundamentalidResponse:
      type: object
      properties:
        ticker:
          type: string
        cikNumber:
          type: string
        revenue:
          type: number
        netIncome:
          type: number
        totalAssets:
          type: number
        latestFiscalYear:
          type: integer
        latestForm:
          type: string
        latestPeriodEnd:
          type: string
          format: date
        lastUpdated:
          type: string
          format: date-time
        revenueConceptUsed:
          type: string
        netIncomeConceptUsed:
          type: string
        reportingCurrency:
          type: string
    GetApiV1SecManagersVanguardResponse:
      type: object
      properties:
        holderKey:
          type: string
        holderName:
          type: string
        periodOfReport:
          type: string
        isPeriodComplete:
          type: boolean
        positionCount:
          type: number
        totalValue:
          type: number
        storedPositionCount:
          type: number
        storedValueShare:
          type: number
        positions:
          type: array
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-Api-Key
security:
- apiKey: []
tags:
- name: Api