Finnhub

{
  "from": {
    "description": "From date, YYYY-MM-DD",
    "required": false,
    "type": "string"
  },
  "international": {
    "description": "Include international markets (default false)",
    "required": false,
    "type": "boolean"
  },
  "symbol": {
    "description": "Filter by symbol",
    "required": false,
    "type": "string"
  },
  "to": {
    "description": "To date, YYYY-MM-DD",
    "required": false,
    "type": "string"
  }
}

{
  "properties": {
    "earningsCalendar": {
      "items": {
        "properties": {
          "date": {
            "type": "string"
          },
          "epsActual": {
            "type": "number"
          },
          "epsEstimate": {
            "type": "number"
          },
          "hour": {
            "description": "bmo, amc or dmh",
            "type": "string"
          },
          "quarter": {
            "type": "integer"
          },
          "revenueActual": {
            "type": "number"
          },
          "revenueEstimate": {
            "type": "number"
          },
          "symbol": {
            "type": "string"
          },
          "year": {
            "type": "integer"
          }
        },
        "type": "object"
      },
      "type": "array"
    }
  },
  "type": "object"
}

{
  "earningsCalendar": [
    {
      "date": "2026-07-31",
      "epsActual": null,
      "epsEstimate": 1.42,
      "hour": "amc",
      "quarter": 3,
      "revenueActual": null,
      "revenueEstimate": 89000000000,
      "symbol": "AAPL",
      "year": 2026
    }
  ]
}

{
  "properties": {
    "from": {
      "description": "From date, YYYY-MM-DD.",
      "example": "2024-01-01",
      "type": "string"
    },
    "to": {
      "description": "To date, YYYY-MM-DD.",
      "example": "2024-12-31",
      "type": "string"
    }
  },
  "required": [
    "from",
    "to"
  ],
  "type": "object"
}

{
  "properties": {
    "ipoCalendar": {
      "description": "Array of IPO events.",
      "items": {
        "properties": {
          "date": {
            "description": "IPO date.",
            "format": "date",
            "type": "string"
          },
          "exchange": {
            "description": "Exchange.",
            "type": "string"
          },
          "name": {
            "description": "Company's name.",
            "type": "string"
          },
          "numberOfShares": {
            "description": "Number of shares offered during the IPO.",
            "format": "float",
            "type": "number"
          },
          "price": {
            "description": "Projected price or price range.",
            "type": "string"
          },
          "status": {
            "description": "IPO status. Can take 1 of the following values: <code>expected</code>,<code>priced</code>,<code>withdrawn</code>,<code>filed</code>",
            "type": "string"
          },
          "symbol": {
            "description": "Symbol.",
            "type": "string"
          },
          "totalSharesValue": {
            "description": "Total shares value.",
            "format": "float",
            "type": "number"
          }
        },
        "type": "object"
      },
      "type": "array"
    }
  },
  "type": "object"
}

{
  "from": {
    "description": "From date, YYYY-MM-DD",
    "required": true,
    "type": "string"
  },
  "symbol": {
    "description": "Stock symbol, e.g. AAPL",
    "required": true,
    "type": "string"
  },
  "to": {
    "description": "To date, YYYY-MM-DD",
    "required": true,
    "type": "string"
  }
}

{
  "items": {
    "properties": {
      "category": {
        "type": "string"
      },
      "datetime": {
        "description": "UNIX timestamp",
        "type": "integer"
      },
      "headline": {
        "type": "string"
      },
      "id": {
        "type": "integer"
      },
      "image": {
        "type": "string"
      },
      "related": {
        "type": "string"
      },
      "source": {
        "type": "string"
      },
      "summary": {
        "type": "string"
      },
      "url": {
        "type": "string"
      }
    },
    "type": "object"
  },
  "type": "array"
}

[
  {
    "category": "company news",
    "datetime": 1718841600,
    "headline": "Apple announces new product line",
    "id": 131982009,
    "image": "https://example.com/img.jpg",
    "related": "AAPL",
    "source": "Reuters",
    "summary": "Summary of the article.",
    "url": "https://example.com/article"
  }
]

{
  "properties": {},
  "required": [],
  "type": "object"
}

{
  "items": {
    "properties": {
      "code2": {
        "description": "Alpha 2 code",
        "type": "string"
      },
      "code3": {
        "description": "Alpha 3 code",
        "type": "string"
      },
      "codeNo": {
        "description": "UN code",
        "type": "string"
      },
      "country": {
        "description": "Country name",
        "type": "string"
      },
      "countryRiskPremium": {
        "description": "Country risk premium",
        "format": "float",
        "type": "number"
      },
      "currency": {
        "description": "Currency name",
        "type": "string"
      },
      "currencyCode": {
        "description": "Currency code",
        "type": "string"
      },
      "defaultSpread": {
        "description": "Default spread",
        "format": "float",
        "type": "number"
      },
      "equityRiskPremium": {
        "description": "Equity risk premium",
        "format": "float",
        "type": "number"
      },
      "logo": {
        "description": "Flag image",
        "type": "string"
      },
      "rating": {
        "description": "Moody's credit risk rating.",
        "type": "string"
      },
      "region": {
        "description": "Region",
        "type": "string"
      },
      "subRegion": {
        "description": "Sub-Region",
        "type": "string"
      }
    },
    "type": "object"
  },
  "type": "array"
}

{
  "properties": {},
  "required": [],
  "type": "object"
}

{
  "items": {
    "type": "string"
  },
  "type": "array"
}

{
  "properties": {
    "exchange": {
      "description": "Exchange you want to get the list of symbols from.",
      "example": "BINANCE",
      "type": "string"
    }
  },
  "required": [
    "exchange"
  ],
  "type": "object"
}

{
  "items": {
    "properties": {
      "description": {
        "description": "Symbol description",
        "type": "string"
      },
      "displaySymbol": {
        "description": "Display symbol name.",
        "type": "string"
      },
      "symbol": {
        "description": "Unique symbol used to identify this symbol used in <code>/crypto/candle</code> endpoint.",
        "type": "string"
      }
    },
    "type": "object"
  },
  "type": "array"
}

{
  "properties": {},
  "required": [],
  "type": "object"
}

{
  "items": {
    "properties": {
      "eventDescription": {
        "description": "Event's description.",
        "type": "string"
      },
      "fromDate": {
        "description": "Start time of the event in EST.",
        "formatIgnore": "date-time",
        "type": "string"
      },
      "toDate": {
        "description": "End time of the event in EST.",
        "formatIgnore": "date-time",
        "type": "string"
      },
      "url": {
        "description": "URL.",
        "type": "string"
      }
    },
    "type": "object"
  },
  "type": "array"
}

{
  "properties": {},
  "required": [],
  "type": "object"
}

{
  "items": {
    "type": "string"
  },
  "type": "array"
}

{
  "properties": {
    "exchange": {
      "description": "Exchange you want to get the list of symbols from.",
      "example": "OANDA",
      "type": "string"
    }
  },
  "required": [
    "exchange"
  ],
  "type": "object"
}

{
  "items": {
    "properties": {
      "description": {
        "description": "Symbol description",
        "type": "string"
      },
      "displaySymbol": {
        "description": "Display symbol name.",
        "type": "string"
      },
      "symbol": {
        "description": "Unique symbol used to identify this symbol used in <code>/forex/candle</code> endpoint.",
        "type": "string"
      }
    },
    "type": "object"
  },
  "type": "array"
}

{
  "category": {
    "description": "One of general, forex, crypto, merger",
    "required": true,
    "type": "string"
  },
  "minId": {
    "description": "Only return news after this id (default 0)",
    "required": false,
    "type": "integer"
  }
}

{
  "items": {
    "properties": {
      "category": {
        "type": "string"
      },
      "datetime": {
        "description": "UNIX timestamp",
        "type": "integer"
      },
      "headline": {
        "type": "string"
      },
      "id": {
        "type": "integer"
      },
      "image": {
        "type": "string"
      },
      "related": {
        "type": "string"
      },
      "source": {
        "type": "string"
      },
      "summary": {
        "type": "string"
      },
      "url": {
        "type": "string"
      }
    },
    "type": "object"
  },
  "type": "array"
}

[
  {
    "category": "top news",
    "datetime": 1718841600,
    "headline": "Markets rally on rate-cut hopes",
    "id": 7654321,
    "image": "https://example.com/news.jpg",
    "related": "",
    "source": "Reuters",
    "summary": "Summary of the article.",
    "url": "https://example.com/news"
  }
]

{
  "symbol": {
    "description": "Stock symbol, e.g. AAPL",
    "required": true,
    "type": "string"
  }
}

{
  "properties": {
    "c": {
      "description": "Current price",
      "type": "number"
    },
    "d": {
      "description": "Change",
      "type": "number"
    },
    "dp": {
      "description": "Percent change",
      "type": "number"
    },
    "h": {
      "description": "High",
      "type": "number"
    },
    "l": {
      "description": "Low",
      "type": "number"
    },
    "o": {
      "description": "Open",
      "type": "number"
    },
    "pc": {
      "description": "Previous close",
      "type": "number"
    }
  },
  "type": "object"
}

{
  "c": 214.29,
  "d": 1.1,
  "dp": 0.5156,
  "h": 215.18,
  "l": 211.3,
  "o": 211.8,
  "pc": 213.19
}

{
  "exchange": {
    "description": "Limit results to a single exchange",
    "required": false,
    "type": "string"
  },
  "q": {
    "description": "Query: ticker, company name, ISIN or CUSIP",
    "required": true,
    "type": "string"
  }
}

{
  "properties": {
    "count": {
      "type": "integer"
    },
    "result": {
      "items": {
        "properties": {
          "description": {
            "type": "string"
          },
          "displaySymbol": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    }
  },
  "type": "object"
}

{
  "count": 1,
  "result": [
    {
      "description": "APPLE INC",
      "displaySymbol": "AAPL",
      "symbol": "AAPL",
      "type": "Common Stock"
    }
  ]
}

{
  "properties": {
    "limit": {
      "description": "Limit number of periods returned. Omit for the full history.",
      "example": 4,
      "type": "integer"
    },
    "symbol": {
      "description": "Symbol of the company, e.g. AAPL.",
      "example": "AAPL",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "type": "object"
}

{
  "items": {
    "properties": {
      "actual": {
        "description": "Actual earning result.",
        "format": "float",
        "type": "number"
      },
      "estimate": {
        "description": "Estimated earning.",
        "format": "float",
        "type": "number"
      },
      "period": {
        "description": "Reported period.",
        "format": "date",
        "type": "string"
      },
      "quarter": {
        "description": "Fiscal quarter.",
        "format": "int64",
        "type": "integer"
      },
      "surprise": {
        "description": "Surprise - The difference between actual and estimate.",
        "format": "float",
        "type": "number"
      },
      "surprisePercent": {
        "description": "Surprise percent.",
        "format": "float",
        "type": "number"
      },
      "symbol": {
        "description": "Company symbol.",
        "type": "string"
      },
      "year": {
        "description": "Fiscal year.",
        "format": "int64",
        "type": "integer"
      }
    },
    "type": "object"
  },
  "type": "array"
}

{
  "properties": {
    "accessNumber": {
      "description": "Access number of a specific report to retrieve data from.",
      "example": "0000320193-24-000123",
      "type": "string"
    },
    "cik": {
      "description": "CIK.",
      "example": "320193",
      "type": "string"
    },
    "form": {
      "description": "Filter by form type. Use 'NT 10-K' to find non-timely filings.",
      "example": "10-K",
      "type": "string"
    },
    "from": {
      "description": "From date, YYYY-MM-DD.",
      "example": "2024-01-01",
      "type": "string"
    },
    "symbol": {
      "description": "Symbol. Leave symbol, cik and accessNumber empty to list the latest filings.",
      "example": "AAPL",
      "type": "string"
    },
    "to": {
      "description": "To date, YYYY-MM-DD.",
      "example": "2024-12-31",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

{
  "items": {
    "properties": {
      "acceptedDate": {
        "description": "Accepted date <code>%Y-%m-%d %H:%M:%S</code>.",
        "formatIgnore": "date-time",
        "type": "string"
      },
      "accessNumber": {
        "description": "Access number.",
        "type": "string"
      },
      "cik": {
        "description": "CIK.",
        "type": "string"
      },
      "filedDate": {
        "description": "Filed date <code>%Y-%m-%d %H:%M:%S</code>.",
        "formatIgnore": "date-time",
        "type": "string"
      },
      "filingUrl": {
        "description": "Filing's URL.",
        "type": "string"
      },
      "form": {
        "description": "Form type.",
        "type": "string"
      },
      "reportUrl": {
        "description": "Report's URL.",
        "type": "string"
      },
      "symbol": {
        "description": "Symbol.",
        "type": "string"
      }
    },
    "type": "object"
  },
  "type": "array"
}

{
  "properties": {
    "accessNumber": {
      "description": "Access number of a specific report to retrieve financials from.",
      "example": "0000320193-24-000123",
      "type": "string"
    },
    "cik": {
      "description": "CIK.",
      "example": "320193",
      "type": "string"
    },
    "freq": {
      "default": "annual",
      "description": "Frequency. Defaults to annual.",
      "enum": [
        "annual",
        "quarterly"
      ],
      "type": "string"
    },
    "from": {
      "description": "From date, YYYY-MM-DD. Filters on endDate.",
      "example": "2024-01-01",
      "type": "string"
    },
    "symbol": {
      "description": "Symbol of the company, e.g. AAPL.",
      "example": "AAPL",
      "type": "string"
    },
    "to": {
      "description": "To date, YYYY-MM-DD. Filters on endDate.",
      "example": "2024-12-31",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

{
  "properties": {
    "cik": {
      "description": "CIK",
      "type": "string"
    },
    "data": {
      "description": "Array of filings.",
      "items": {
        "properties": {
          "acceptedDate": {
            "description": "Accepted date <code>%Y-%m-%d %H:%M:%S</code>.",
            "formatIgnore": "date-time",
            "type": "string"
          },
          "accessNumber": {
            "description": "Access number.",
            "type": "string"
          },
          "cik": {
            "description": "CIK.",
            "type": "string"
          },
          "endDate": {
            "description": "Period end date <code>%Y-%m-%d %H:%M:%S</code>.",
            "formatIgnore": "date-time",
            "type": "string"
          },
          "filedDate": {
            "description": "Filed date <code>%Y-%m-%d %H:%M:%S</code>.",
            "formatIgnore": "date-time",
            "type": "string"
          },
          "form": {
            "description": "Form type.",
            "type": "string"
          },
          "quarter": {
            "description": "Quarter.",
            "format": "int64",
            "type": "integer"
          },
          "report": {
            "$ref": "#/definitions/ReportDataMap",
            "description": "Report data.",
            "type": "object"
          },
          "startDate": {
            "description": "Period start date <code>%Y-%m-%d %H:%M:%S</code>.",
            "formatIgnore": "date-time",
            "type": "string"
          },
          "symbol": {
            "description": "Symbol.",
            "type": "string"
          },
          "year": {
            "description": "Year.",
            "format": "int64",
            "type": "integer"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "symbol": {
      "description": "Symbol",
      "type": "string"
    }
  },
  "type": "object"
}

{
  "properties": {
    "from": {
      "description": "From date, YYYY-MM-DD.",
      "example": "2024-01-01",
      "type": "string"
    },
    "symbol": {
      "description": "Symbol of the company, e.g. AAPL.",
      "example": "AAPL",
      "type": "string"
    },
    "to": {
      "description": "To date, YYYY-MM-DD.",
      "example": "2024-12-31",
      "type": "string"
    }
  },
  "required": [
    "symbol",
    "from",
    "to"
  ],
  "type": "object"
}

{
  "properties": {
    "data": {
      "description": "Array of sentiment data.",
      "items": {
        "properties": {
          "change": {
            "description": "Net buying/selling from all insiders' transactions.",
            "format": "int64",
            "type": "integer"
          },
          "month": {
            "description": "Month.",
            "format": "int64",
            "type": "integer"
          },
          "mspr": {
            "description": "Monthly share purchase ratio.",
            "format": "float",
            "type": "number"
          },
          "symbol": {
            "description": "Symbol.",
            "type": "string"
          },
          "year": {
            "description": "Year.",
            "format": "int64",
            "type": "integer"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "symbol": {
      "description": "Symbol of the company.",
      "type": "string"
    }
  },
  "type": "object"
}

{
  "from": {
    "description": "From date, YYYY-MM-DD",
    "required": false,
    "type": "string"
  },
  "symbol": {
    "description": "Stock symbol. Leave blank for the latest across all companies.",
    "required": true,
    "type": "string"
  },
  "to": {
    "description": "To date, YYYY-MM-DD",
    "required": false,
    "type": "string"
  }
}

{
  "properties": {
    "data": {
      "items": {
        "properties": {
          "change": {
            "description": "Positive = buy, negative = sell",
            "type": "number"
          },
          "filingDate": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "share": {
            "description": "Shares held after transaction",
            "type": "number"
          },
          "transactionCode": {
            "type": "string"
          },
          "transactionDate": {
            "type": "string"
          },
          "transactionPrice": {
            "type": "number"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "symbol": {
      "type": "string"
    }
  },
  "type": "object"
}

{
  "data": [
    {
      "change": -50000,
      "filingDate": "2026-05-02",
      "name": "Cook Timothy D",
      "share": 3280000,
      "transactionCode": "S",
      "transactionDate": "2026-04-30",
      "transactionPrice": 210.5
    }
  ],
  "symbol": "AAPL"
}

{
  "properties": {
    "from": {
      "description": "From date, YYYY-MM-DD.",
      "example": "2024-01-01",
      "type": "string"
    },
    "symbol": {
      "description": "Symbol of the company, e.g. AAPL.",
      "example": "AAPL",
      "type": "string"
    },
    "to": {
      "description": "To date, YYYY-MM-DD.",
      "example": "2024-12-31",
      "type": "string"
    }
  },
  "required": [
    "symbol",
    "from",
    "to"
  ],
  "type": "object"
}

{
  "properties": {
    "data": {
      "description": "Array of lobbying activities.",
      "items": {
        "properties": {
          "clientId": {
            "description": "Client ID.",
            "type": "string"
          },
          "country": {
            "description": "Country.",
            "type": "string"
          },
          "date": {
            "description": "Date.",
            "type": "string"
          },
          "description": {
            "description": "Description.",
            "type": "string"
          },
          "documentUrl": {
            "description": "Document's URL.",
            "type": "string"
          },
          "expenses": {
            "description": "Expenses reported by the company.",
            "format": "float",
            "type": "number"
          },
          "houseregistrantId": {
            "description": "House registrant ID.",
            "type": "string"
          },
          "income": {
            "description": "Income reported by lobbying firms.",
            "format": "float",
            "type": "number"
          },
          "name": {
            "description": "Company's name.",
            "type": "string"
          },
          "period": {
            "description": "Period.",
            "type": "string"
          },
          "postedName": {
            "description": "Posted name.",
            "type": "string"
          },
          "registrantId": {
            "description": "Registrant ID.",
            "type": "string"
          },
          "senateId": {
            "description": "Senate ID.",
            "type": "string"
          },
          "symbol": {
            "description": "Symbol.",
            "type": "string"
          },
          "year": {
            "description": "Year.",
            "format": "int64",
            "type": "integer"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "symbol": {
      "description": "Symbol.",
      "type": "string"
    }
  },
  "type": "object"
}

{
  "properties": {
    "exchange": {
      "description": "Exchange code.",
      "example": "US",
      "type": "string"
    }
  },
  "required": [
    "exchange"
  ],
  "type": "object"
}

{
  "properties": {
    "data": {
      "description": "Array of holidays.",
      "items": {
        "properties": {
          "atDate": {
            "description": "Date.",
            "type": "string"
          },
          "eventName": {
            "description": "Holiday's name.",
            "type": "string"
          },
          "tradingHour": {
            "description": "Trading hours for this day if the market is partially closed only.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "exchange": {
      "description": "Exchange.",
      "type": "string"
    },
    "timezone": {
      "description": "Timezone.",
      "type": "string"
    }
  },
  "type": "object"
}

{
  "properties": {
    "exchange": {
      "description": "Exchange code.",
      "example": "US",
      "type": "string"
    }
  },
  "required": [
    "exchange"
  ],
  "type": "object"
}

{
  "properties": {
    "exchange": {
      "description": "Exchange.",
      "type": "string"
    },
    "holiday": {
      "description": "Holiday event.",
      "type": "string"
    },
    "isOpen": {
      "description": "Whether the market is open at the moment.",
      "type": "boolean"
    },
    "session": {
      "description": "Market session. Can be 1 of the following values: <code>pre-market</code>,<code>regular</code>,<code>post-market</code> or <code>null</code> if the market is closed.",
      "type": "string"
    },
    "t": {
      "description": "Current timestamp.",
      "format": "int64",
      "type": "integer"
    },
    "timezone": {
      "description": "Timezone.",
      "type": "string"
    }
  },
  "type": "object"
}

{
  "metric": {
    "description": "Metric group. Use the value all.",
    "required": true,
    "type": "string"
  },
  "symbol": {
    "description": "Stock symbol, e.g. AAPL",
    "required": true,
    "type": "string"
  }
}

{
  "properties": {
    "metric": {
      "description": "Map of key ratios and metrics",
      "type": "object"
    },
    "metricType": {
      "type": "string"
    },
    "series": {
      "description": "Time-series ratios",
      "type": "object"
    },
    "symbol": {
      "type": "string"
    }
  },
  "type": "object"
}

{
  "metric": {
    "52WeekHigh": 237.23,
    "52WeekLow": 164.08,
    "netProfitMarginAnnual": 24.3,
    "peNormalizedAnnual": 31.2
  },
  "metricType": "all",
  "symbol": "AAPL"
}

{
  "properties": {
    "grouping": {
      "default": "subIndustry",
      "description": "Criteria for choosing peers. Defaults to subIndustry.",
      "enum": [
        "sector",
        "industry",
        "subIndustry"
      ],
      "type": "string"
    },
    "symbol": {
      "description": "Symbol of the company, e.g. AAPL.",
      "example": "AAPL",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "type": "object"
}

{
  "items": {
    "type": "string"
  },
  "type": "array"
}

{
  "cusip": {
    "description": "CUSIP",
    "required": false,
    "type": "string"
  },
  "isin": {
    "description": "ISIN",
    "required": false,
    "type": "string"
  },
  "symbol": {
    "description": "Ticker; one of symbol/isin/cusip required",
    "required": false,
    "type": "string"
  }
}

{
  "properties": {
    "country": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "exchange": {
      "type": "string"
    },
    "finnhubIndustry": {
      "type": "string"
    },
    "ipo": {
      "type": "string"
    },
    "logo": {
      "type": "string"
    },
    "marketCapitalization": {
      "type": "number"
    },
    "name": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "shareOutstanding": {
      "type": "number"
    },
    "ticker": {
      "type": "string"
    },
    "weburl": {
      "type": "string"
    }
  },
  "type": "object"
}

{
  "country": "US",
  "currency": "USD",
  "exchange": "NASDAQ NMS - GLOBAL MARKET",
  "finnhubIndustry": "Technology",
  "ipo": "1980-12-12",
  "logo": "https://example.com/aapl.png",
  "marketCapitalization": 3200000,
  "name": "Apple Inc",
  "shareOutstanding": 15000,
  "ticker": "AAPL",
  "weburl": "https://www.apple.com/"
}

{
  "symbol": {
    "description": "Stock symbol, e.g. AAPL",
    "required": true,
    "type": "string"
  }
}

{
  "items": {
    "properties": {
      "buy": {
        "type": "integer"
      },
      "hold": {
        "type": "integer"
      },
      "period": {
        "type": "string"
      },
      "sell": {
        "type": "integer"
      },
      "strongBuy": {
        "type": "integer"
      },
      "strongSell": {
        "type": "integer"
      },
      "symbol": {
        "type": "string"
      }
    },
    "type": "object"
  },
  "type": "array"
}

[
  {
    "buy": 12,
    "hold": 8,
    "period": "2026-06-01",
    "sell": 1,
    "strongBuy": 18,
    "strongSell": 0,
    "symbol": "AAPL"
  }
]

{
  "properties": {
    "currency": {
      "description": "Filter by currency.",
      "example": "USD",
      "type": "string"
    },
    "exchange": {
      "description": "Exchange you want to get the list of symbols from.",
      "example": "US",
      "type": "string"
    },
    "mic": {
      "description": "Filter by MIC code.",
      "example": "XNAS",
      "type": "string"
    },
    "securityType": {
      "description": "Filter by security type (OpenFIGI standard).",
      "example": "Common Stock",
      "type": "string"
    }
  },
  "required": [
    "exchange"
  ],
  "type": "object"
}

{
  "items": {
    "properties": {
      "currency": {
        "description": "Price's currency. This might be different from the reporting currency of fundamental data.",
        "type": "string"
      },
      "description": {
        "description": "Symbol description",
        "type": "string"
      },
      "displaySymbol": {
        "description": "Display symbol name.",
        "type": "string"
      },
      "figi": {
        "description": "FIGI identifier.",
        "type": "string"
      },
      "isin": {
        "description": "ISIN. This field is only available for EU stocks and selected Asian markets. Entitlement from Finnhub is required to access this field.",
        "type": "string"
      },
      "mic": {
        "description": "Primary exchange's MIC.",
        "type": "string"
      },
      "shareClassFIGI": {
        "description": "Global Share Class FIGI.",
        "type": "string"
      },
      "symbol": {
        "description": "Unique symbol used to identify this symbol used in <code>/stock/candle</code> endpoint.",
        "type": "string"
      },
      "symbol2": {
        "description": "Alternative ticker for exchanges with multiple tickers for 1 stock such as BSE.",
        "type": "string"
      },
      "type": {
        "description": "Security type.",
        "type": "string"
      }
    },
    "type": "object"
  },
  "type": "array"
}

{
  "properties": {
    "from": {
      "description": "From date, YYYY-MM-DD. Filters on actionDate.",
      "example": "2024-01-01",
      "type": "string"
    },
    "symbol": {
      "description": "Symbol of the company, e.g. AAPL.",
      "example": "AAPL",
      "type": "string"
    },
    "to": {
      "description": "To date, YYYY-MM-DD. Filters on actionDate.",
      "example": "2024-12-31",
      "type": "string"
    }
  },
  "required": [
    "symbol",
    "from",
    "to"
  ],
  "type": "object"
}

{
  "properties": {
    "data": {
      "description": "Array of government's spending data points.",
      "items": {
        "properties": {
          "actionDate": {
            "description": "Period.",
            "type": "string"
          },
          "awardDescription": {
            "description": "Description.",
            "type": "string"
          },
          "awardingAgencyName": {
            "description": "Award agency.",
            "type": "string"
          },
          "awardingOfficeName": {
            "description": "Award office name.",
            "type": "string"
          },
          "awardingSubAgencyName": {
            "description": "Award sub-agency.",
            "type": "string"
          },
          "country": {
            "description": "Recipient's country.",
            "type": "string"
          },
          "naicsCode": {
            "description": "NAICS code.",
            "type": "string"
          },
          "performanceCity": {
            "description": "Performance city.",
            "type": "string"
          },
          "performanceCongressionalDistrict": {
            "description": "Performance congressional district.",
            "type": "string"
          },
          "performanceCountry": {
            "description": "Performance country.",
            "type": "string"
          },
          "performanceCounty": {
            "description": "Performance county.",
            "type": "string"
          },
          "performanceEndDate": {
            "description": "Performance end date.",
            "type": "string"
          },
          "performanceStartDate": {
            "description": "Performance start date.",
            "type": "string"
          },
          "performanceState": {
            "description": "Performance state.",
            "type": "string"
          },
          "performanceZipCode": {
            "description": "Performance zip code.",
            "type": "string"
          },
          "permalink": {
            "description": "Permalink.",
            "type": "string"
          },
          "recipientName": {
            "description": "Company's name.",
            "type": "string"
          },
          "recipientParentName": {
            "description": "Company's name.",
            "type": "string"
          },
          "symbol": {
            "description": "Symbol.",
            "type": "string"
          },
          "totalValue": {
            "description": "Income reported by lobbying firms.",
            "format": "float",
            "type": "number"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "symbol": {
      "description": "Symbol.",
      "type": "string"
    }
  },
  "type": "object"
}

{
  "properties": {
    "from": {
      "description": "From date, YYYY-MM-DD.",
      "example": "2024-01-01",
      "type": "string"
    },
    "symbol": {
      "description": "Symbol of the company, e.g. AAPL.",
      "example": "AAPL",
      "type": "string"
    },
    "to": {
      "description": "To date, YYYY-MM-DD.",
      "example": "2024-12-31",
      "type": "string"
    }
  },
  "required": [
    "symbol",
    "from",
    "to"
  ],
  "type": "object"
}

{
  "properties": {
    "data": {
      "description": "Array of patents.",
      "items": {
        "properties": {
          "applicationNumber": {
            "description": "Application Number.",
            "type": "string"
          },
          "companyFilingName": {
            "description": "Array of companies' name on the patent.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": {
            "description": "Description.",
            "type": "string"
          },
          "filingDate": {
            "description": "Filing date.",
            "type": "string"
          },
          "filingStatus": {
            "description": "Filing status.",
            "type": "string"
          },
          "patentNumber": {
            "description": "Patent number.",
            "type": "string"
          },
          "patentType": {
            "description": "Patent's type.",
            "type": "string"
          },
          "publicationDate": {
            "description": "Publication date.",
            "type": "string"
          },
          "url": {
            "description": "URL of the original article.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "symbol": {
      "description": "Symbol.",
      "type": "string"
    }
  },
  "type": "object"
}

{
  "properties": {
    "from": {
      "description": "From date, YYYY-MM-DD. Filters on beginDate.",
      "example": "2024-01-01",
      "type": "string"
    },
    "symbol": {
      "description": "Symbol of the company, e.g. AAPL.",
      "example": "AAPL",
      "type": "string"
    },
    "to": {
      "description": "To date, YYYY-MM-DD. Filters on beginDate.",
      "example": "2024-12-31",
      "type": "string"
    }
  },
  "required": [
    "symbol",
    "from",
    "to"
  ],
  "type": "object"
}

{
  "properties": {
    "data": {
      "description": "Array of H1b and Permanent visa applications.",
      "items": {
        "properties": {
          "beginDate": {
            "description": "Job's start date.",
            "type": "string"
          },
          "caseNumber": {
            "description": "Case number.",
            "type": "string"
          },
          "caseStatus": {
            "description": "Case status.",
            "type": "string"
          },
          "employerName": {
            "description": "Company's name.",
            "type": "string"
          },
          "endDate": {
            "description": "Job's end date.",
            "type": "string"
          },
          "fullTimePosition": {
            "description": "Full-time position flag.",
            "type": "string"
          },
          "h1bDependent": {
            "description": "H1B dependent flag.",
            "type": "string"
          },
          "jobTitle": {
            "description": "Job Title.",
            "type": "string"
          },
          "quarter": {
            "description": "Quarter.",
            "format": "int64",
            "type": "integer"
          },
          "receivedDate": {
            "description": "Received date.",
            "type": "string"
          },
          "socCode": {
            "description": "SOC Code. A list of SOC code can be found <a href=\"https://www.bls.gov/oes/current/oes_stru.htm\" target=\"_blank\">here</a>.",
            "type": "string"
          },
          "symbol": {
            "description": "Symbol.",
            "type": "string"
          },
          "visaClass": {
            "description": "Visa class.",
            "type": "string"
          },
          "wageLevel": {
            "description": "Wage level.",
            "type": "string"
          },
          "wageRangeFrom": {
            "description": "Wage range from.",
            "format": "float",
            "type": "number"
          },
          "wageRangeTo": {
            "description": "Wage range to.",
            "format": "float",
            "type": "number"
          },
          "wageUnitOfPay": {
            "description": "Wage unit of pay.",
            "type": "string"
          },
          "worksiteAddress": {
            "description": "Worksite address.",
            "type": "string"
          },
          "worksiteCity": {
            "description": "Worksite city.",
            "type": "string"
          },
          "worksiteCounty": {
            "description": "Worksite county.",
            "type": "string"
          },
          "worksitePostalCode": {
            "description": "Worksite postal code.",
            "type": "string"
          },
          "worksiteState": {
            "description": "Worksite state.",
            "type": "string"
          },
          "year": {
            "description": "Year.",
            "format": "int64",
            "type": "integer"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "symbol": {
      "description": "Symbol.",
      "type": "string"
    }
  },
  "type": "object"
}