Financial Modeling Prep API

naftiko: 1.0.0-alpha2
info:
  label: Financial Modeling Prep API
  description: Financial Modeling Prep (FMP) provides financial market data including real-time and historical stock quotes,
    company fundamentals, financial statements (income, balance sheet, cash flow), insider transactions, earnings, ratios,
    and economic data. This OpenAPI spec covers a representative subset of the public REST API.
  tags:
  - Financial
  - Modeling
  - Prep
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: financial-modeling-prep
    baseUri: https://financialmodelingprep.com/api/v3
    description: Financial Modeling Prep API HTTP API.
    authentication:
      type: apikey
      in: query
      name: apikey
      value: '{{FINANCIAL_MODELING_PREP_TOKEN}}'
    resources:
    - name: quote-symbol
      path: /quote/{symbol}
      operations:
      - name: getquote
        method: GET
        description: Get real-time stock quote
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: historical-price-full-symbol
      path: /historical-price-full/{symbol}
      operations:
      - name: gethistoricalprice
        method: GET
        description: Get historical end-of-day prices
        inputParameters:
        - name: from
          in: query
          type: string
        - name: to
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: income-statement-symbol
      path: /income-statement/{symbol}
      operations:
      - name: getincomestatement
        method: GET
        description: Get company income statement
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: balance-sheet-statement-symbol
      path: /balance-sheet-statement/{symbol}
      operations:
      - name: getbalancesheet
        method: GET
        description: Get company balance sheet
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: cash-flow-statement-symbol
      path: /cash-flow-statement/{symbol}
      operations:
      - name: getcashflowstatement
        method: GET
        description: Get company cash flow statement
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: profile-symbol
      path: /profile/{symbol}
      operations:
      - name: getcompanyprofile
        method: GET
        description: Get company profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: search
      path: /search
      operations:
      - name: searchsymbols
        method: GET
        description: Search for ticker symbols
        inputParameters:
        - name: query
          in: query
          type: string
          required: true
        - name: limit
          in: query
          type: integer
        - name: exchange
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: stock-list
      path: /stock/list
      operations:
      - name: liststocks
        method: GET
        description: List all available stock symbols
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: insider-trading
      path: /insider-trading
      operations:
      - name: getinsidertrading
        method: GET
        description: Get insider transactions
        inputParameters:
        - name: symbol
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: ratios-symbol
      path: /ratios/{symbol}
      operations:
      - name: getfinancialratios
        method: GET
        description: Get company financial ratios
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: financial-modeling-prep-rest
    description: REST adapter for Financial Modeling Prep API.
    resources:
    - path: /quote/{symbol}
      name: getquote
      operations:
      - method: GET
        name: getquote
        description: Get real-time stock quote
        call: financial-modeling-prep.getquote
        outputParameters:
        - type: object
          mapping: $.
    - path: /historical-price-full/{symbol}
      name: gethistoricalprice
      operations:
      - method: GET
        name: gethistoricalprice
        description: Get historical end-of-day prices
        call: financial-modeling-prep.gethistoricalprice
        outputParameters:
        - type: object
          mapping: $.
    - path: /income-statement/{symbol}
      name: getincomestatement
      operations:
      - method: GET
        name: getincomestatement
        description: Get company income statement
        call: financial-modeling-prep.getincomestatement
        outputParameters:
        - type: object
          mapping: $.
    - path: /balance-sheet-statement/{symbol}
      name: getbalancesheet
      operations:
      - method: GET
        name: getbalancesheet
        description: Get company balance sheet
        call: financial-modeling-prep.getbalancesheet
        outputParameters:
        - type: object
          mapping: $.
    - path: /cash-flow-statement/{symbol}
      name: getcashflowstatement
      operations:
      - method: GET
        name: getcashflowstatement
        description: Get company cash flow statement
        call: financial-modeling-prep.getcashflowstatement
        outputParameters:
        - type: object
          mapping: $.
    - path: /profile/{symbol}
      name: getcompanyprofile
      operations:
      - method: GET
        name: getcompanyprofile
        description: Get company profile
        call: financial-modeling-prep.getcompanyprofile
        outputParameters:
        - type: object
          mapping: $.
    - path: /search
      name: searchsymbols
      operations:
      - method: GET
        name: searchsymbols
        description: Search for ticker symbols
        call: financial-modeling-prep.searchsymbols
        outputParameters:
        - type: object
          mapping: $.
    - path: /stock/list
      name: liststocks
      operations:
      - method: GET
        name: liststocks
        description: List all available stock symbols
        call: financial-modeling-prep.liststocks
        outputParameters:
        - type: object
          mapping: $.
    - path: /insider-trading
      name: getinsidertrading
      operations:
      - method: GET
        name: getinsidertrading
        description: Get insider transactions
        call: financial-modeling-prep.getinsidertrading
        outputParameters:
        - type: object
          mapping: $.
    - path: /ratios/{symbol}
      name: getfinancialratios
      operations:
      - method: GET
        name: getfinancialratios
        description: Get company financial ratios
        call: financial-modeling-prep.getfinancialratios
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: financial-modeling-prep-mcp
    transport: http
    description: MCP adapter for Financial Modeling Prep API for AI agent use.
    tools:
    - name: getquote
      description: Get real-time stock quote
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: financial-modeling-prep.getquote
      outputParameters:
      - type: object
        mapping: $.
    - name: gethistoricalprice
      description: Get historical end-of-day prices
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: financial-modeling-prep.gethistoricalprice
      with:
        from: tools.from
        to: tools.to
      inputParameters:
      - name: from
        type: string
        description: from
      - name: to
        type: string
        description: to
      outputParameters:
      - type: object
        mapping: $.
    - name: getincomestatement
      description: Get company income statement
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: financial-modeling-prep.getincomestatement
      outputParameters:
      - type: object
        mapping: $.
    - name: getbalancesheet
      description: Get company balance sheet
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: financial-modeling-prep.getbalancesheet
      outputParameters:
      - type: object
        mapping: $.
    - name: getcashflowstatement
      description: Get company cash flow statement
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: financial-modeling-prep.getcashflowstatement
      outputParameters:
      - type: object
        mapping: $.
    - name: getcompanyprofile
      description: Get company profile
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: financial-modeling-prep.getcompanyprofile
      outputParameters:
      - type: object
        mapping: $.
    - name: searchsymbols
      description: Search for ticker symbols
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: financial-modeling-prep.searchsymbols
      with:
        query: tools.query
        limit: tools.limit
        exchange: tools.exchange
      inputParameters:
      - name: query
        type: string
        description: query
        required: true
      - name: limit
        type: integer
        description: limit
      - name: exchange
        type: string
        description: exchange
      outputParameters:
      - type: object
        mapping: $.
    - name: liststocks
      description: List all available stock symbols
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: financial-modeling-prep.liststocks
      outputParameters:
      - type: object
        mapping: $.
    - name: getinsidertrading
      description: Get insider transactions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: financial-modeling-prep.getinsidertrading
      with:
        symbol: tools.symbol
      inputParameters:
      - name: symbol
        type: string
        description: symbol
      outputParameters:
      - type: object
        mapping: $.
    - name: getfinancialratios
      description: Get company financial ratios
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: financial-modeling-prep.getfinancialratios
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    FINANCIAL_MODELING_PREP_TOKEN: FINANCIAL_MODELING_PREP_TOKEN