Query structured spec data via REST or MCP. Get exactly what your agent needs.
https://api.marketdata.app
/v1/indices/candles/{resolution}/{symbol}
Get historical price candles for an index.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| format | query | optional | string | The format parameter is used to specify the format for your data. We support JSON and CSV formats. The default format is JSON. |
| resolution | path | required | string | The duration of each candle. Minutely Resolutions: (1, 3, 5, 15, 30, 45, ...) Hourly Resolutions: (H, 1H, 2H, ...) Daily Resolutions: (D, 1D, 2D, ...) Weekly Resolutions: (W, 1W, 2W, ...) Monthly Resolutions: (M, 1M, 2M, ...) Yearly Resolutions:(Y, 1Y, 2Y, ...)') |
| symbol | path | required | string | The index's ticker symbol. If no exchange is specified. You may embed the exchange in the ticker symbol using the Yahoo Finance or TradingView formats. |
| date | query | optional | string | Use to lookup historical candles from a specific trading day. Accepted date inputs: ISO 8601, unix, spreadsheet. |
| from | query | optional | string | The leftmost candle on a chart (inclusive). If you use countback, to is not required. Accepted timestamp inputs: ISO 8601, unix, spreadsheet. |
| to | query | optional | string | The rightmost candle on a chart (not inclusive). Accepted timestamp inputs: ISO 8601, unix, spreadsheet. |
| countback | query | optional | integer | Countback will fetch a number of candles before (to the left of) to If you use from, countback is not required. |
| dateformat | query | optional | string | The dateformat parameter allows you specify the format you wish to receive date and time information in. |
| limit | query | optional | integer | The limit parameter allows you to limit the number of results for a particular API call or override an endpoint’s default limits to get more data. |
| offset | query | optional | integer | The offset parameter is used together with limit to allow you to implement pagination in your application. Offset will allow you to return values starting at a certain value. |
| headers | query | optional | boolean | The headers parameter is used to turn off headers when using CSV output. |
| columns | query | optional | string | The columns parameter is used to limit the results and only request the columns you need. The most common use of this feature is to embed a single numeric result from one of the end points in a spreadsheet cell. |
| human | query | optional | boolean | Use human-readable attribute names in the JSON or CSV output instead of the standard camelCase attribute names. |
GET /v1/indices/candles/{resolution}/{symbol}
/v1/indices/quotes/{symbol}
Get last quote for an index.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| format | query | optional | string | The format parameter is used to specify the format for your data. We support JSON and CSV formats. The default format is JSON. |
| symbol | path | required | string | The index's ticker symbol. If no exchange is specified. You may embed the exchange in the ticker symbol using the Yahoo Finance or TradingView formats. |
| dateformat | query | optional | string | The dateformat parameter allows you specify the format you wish to receive date and time information in. |
| limit | query | optional | integer | The limit parameter allows you to limit the number of results for a particular API call or override an endpoint's default limits to get more data. |
| offset | query | optional | integer | The offset parameter is used together with limit to allow you to implement pagination in your application. Offset will allow you to return values starting at a certain value. |
| headers | query | optional | boolean | The headers parameter is used to turn off headers when using CSV output. |
| columns | query | optional | string | The columns parameter is used to limit the results and only request the columns you need. The most common use of this feature is to embed a single numeric result from one of the end points in a spreadsheet cell. |
| human | query | optional | boolean | Use human-readable attribute names in the JSON or CSV output instead of the standard camelCase attribute names. |
GET /v1/indices/quotes/{symbol}
/v1/markets/status
Get market status ("open" or "closed") for a date or range of dates.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| format | query | optional | string | The format parameter is used to specify the format for your data. We support JSON and CSV formats. The default format is JSON. |
| date | query | optional | string | Use to lookup status from a specific trading day. Accepted date inputs: ISO 8601, unix, spreadsheet. |
| from | query | optional | string | Limit the status to dates after from (inclusive). Should be combined with to to create a range. Accepted date inputs: ISO 8601, unix, spreadsheet. |
| to | query | optional | string | Limit the status to dates before to (inclusive). Should be combined with from to create a range. Accepted date inputs: ISO 8601, unix, spreadsheet. |
| countback | query | optional | integer | Countback will fetch a number of dates before (to the left of) to. If you use from, countback is not required. |
| country | query | optional | string | Use to specify the country of the exchange. Use the two digit ISO 3166 country code. If no country is specified, US exchanges will be assumed. |
| dateformat | query | optional | string | The dateformat parameter allows you specify the format you wish to receive date and time information in. |
| limit | query | optional | integer | The limit parameter allows you to limit the number of results for a particular API call or override an endpoint’s default limits to get more data. |
| offset | query | optional | integer | The offset parameter is used together with limit to allow you to implement pagination in your application. Offset will allow you to return values starting at a certain value. |
| headers | query | optional | boolean | The headers parameter is used to turn off headers when using CSV output. |
| columns | query | optional | string | The columns parameter is used to limit the results and only request the columns you need. The most common use of this feature is to embed a single numeric result from one of the end points in a spreadsheet cell. |
| human | query | optional | boolean | Use human-readable attribute names in the JSON or CSV output instead of the standard camelCase attribute names. |
GET /v1/markets/status
/v1/options/chain/{underlying}
Get a current or historical end of day options chain for an underlying ticker symbol. Optional parameters allow for extensive filtering of the chain. Use the optionSymbol returned from this endpoint to get quotes, greeks, or other information using the other endpoints.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| format | query | optional | string | The format parameter is used to specify the format for your data. We support JSON and CSV formats. The default format is JSON. |
| underlying | path | required | string | The underlying ticker symbol for the options chain you wish to lookup. Ticker Formats: (TICKER, TICKER.EX, EXCHANGE:TICKER) |
| date | query | optional | string | Use to lookup a historical end of day options chain from a specific trading day. If no date is specified the chain will be the most current chain available during market hours. When the market is closed the chain will be from the last trading day. Accepted date inputs: ISO 8601, unix, spreadsheet. |
| expiration | query | optional | string | Limit the option chain to a specific expiration date. Accepted date inputs: ISO 8601, unix, spreadsheet. If omitted all expirations will be returned. |
| from | query | optional | string | Limit the option chain to expiration dates after from (inclusive). Should be combined with to to create a range. Accepted date inputs: ISO 8601, unix, spreadsheet. If omitted all expirations will be returned. |
| to | query | optional | string | Limit the option chain to expiration dates before to (not inclusive). Should be combined with from to create a range. Accepted date inputs: ISO 8601, unix, spreadsheet. If omitted all expirations will be returned. |
| month | query | optional | integer | Limit the option chain to options that expire in a specific month (1-12). |
| year | query | optional | integer | Limit the option chain to options that expire in a specific year. |
| weekly | query | optional | boolean | Limit the option chain to weekly expirations by setting weekly to true and omitting the monthly and quarterly parameters. If set to false, no weekly expirations will be returned. |
| monthly | query | optional | boolean | Limit the option chain to standard monthly expirations by setting monthly to true and omitting the weekly and quarterly parameters. If set to false, no monthly expirations will be returned. |
| quarterly | query | optional | boolean | Limit the option chain to quarterly expirations by setting quarterly to true and omitting the weekly and monthly parameters. If set to false, no quarterly expirations will be returned. |
| dte | query | optional | integer | Days to expiry. Limit the option chain to a single expiration date closest to the dte provided. Should not be used together with from and to. Take care before combining with weekly, monthly, quarterly, since that will limit the expirations dte can return. If you are using the date parameter, dte is relative to the date provided. |
| side | query | optional | string | Limit the option chain to either call or put. If omitted, both sides will be returned. |
| range | query | optional | string | Limit the option chain to strikes that are in the money, out of the money, or include all. If omitted all options will be returned. Valid inputs: itm, otm, all. |
| strike | query | optional | number | Limit the option chain to options with the specific strike specified. |
| minOpenInterest | query | optional | number | Limit the option chain to options with an open interest greater than or equal to the number provided. Can be combined with minVolume and minLiquidity to further filter. |
| minVolume | query | optional | integer | Limit the option chain to options with an volume transacted greater than or equal to the number provided. |
| maxBidAskSpread | query | optional | number | Limit the option chain to options with a bid-ask spread less than or equal to the number provided. |
| maxBidAskSpreadPct | query | optional | number | Limit the option chain to options with a bid-ask spread less than or equal to the percent provided (relative to the underlying). For example, a value of 0.5% would exclude all options trading with a bid-ask spread greater than $1.00 in an underlying that trades at $200. |
| nonstandard | query | optional | boolean | Include non-standard contracts by nonstandard to true. If set to false, no non-standard options expirations will be returned. If no parameter is provided, the output will default to false. |
| dateformat | query | optional | string | The dateformat parameter allows you specify the format you wish to receive date and time information in. |
| limit | query | optional | integer | The limit parameter allows you to limit the number of results for a particular API call or override an endpoint’s default limits to get more data. |
| offset | query | optional | integer | The offset parameter is used together with limit to allow you to implement pagination in your application. Offset will allow you to return values starting at a certain value. |
| headers | query | optional | boolean | The headers parameter is used to turn off headers when using CSV output. |
| columns | query | optional | string | The columns parameter is used to limit the results and only request the columns you need. The most common use of this feature is to embed a single numeric result from one of the end points in a spreadsheet cell. |
| symbol_lookup | query | optional | boolean | |
| quote | query | optional | boolean | Include quotes |
| human | query | optional | boolean | Use human-readable attribute names in the JSON or CSV output instead of the standard camelCase attribute names. |
GET /v1/options/chain/{underlying}
/v1/options/expirations/{underlying}
Get a list of current or historical option expiration dates for an underlying symbol. If no optional parameters are used, the endpoint returns the expirations for strike in the chain.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| format | query | optional | string | The format parameter is used to specify the format for your data. We support JSON and CSV formats. The default format is JSON. |
| underlying | path | required | string | The underlying ticker symbol for the options chain you wish to lookup. Ticker Formats: (TICKER, TICKER.EX, EXCHANGE:TICKER) |
| strike | query | optional | number | Limit the lookup of expiration dates to the strike provide. This will cause the endpoint to only return expiration dates that include this strike. |
| date | query | optional | string | Use to lookup a historical list of expiration dates from a specific previous trading day. If date is omitted the expiration dates will be from the current trading day during market hours or from the last trading day when the market is closed. Accepted date inputs: ISO 8601, unix, spreadsheet. |
| dateformat | query | optional | string | The dateformat parameter allows you specify the format you wish to receive date and time information in. |
| limit | query | optional | integer | The limit parameter allows you to limit the number of results for a particular API call or override an endpoint’s default limits to get more data. |
| offset | query | optional | integer | The offset parameter is used together with limit to allow you to implement pagination in your application. Offset will allow you to return values starting at a certain value. |
| headers | query | optional | boolean | The headers parameter is used to turn off headers when using CSV output. |
| columns | query | optional | string | The columns parameter is used to limit the results and only request the columns you need. The most common use of this feature is to embed a single numeric result from one of the end points in a spreadsheet cell. |
| symbol_lookup | query | optional | boolean | |
| human | query | optional | boolean | Use human-readable attribute names in the JSON or CSV output instead of the standard camelCase attribute names. |
GET /v1/options/expirations/{underlying}
/v1/options/lookup/{userInput}
Generate a properly formatted OCC option symbol based on the user's human-readable description of an option. This endpoint converts text such as "AAPL 7/26/23 $200 Call" to OCC option symbol format: AAPL230726C00200000. The user input must be URL-encoded.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| format | query | optional | string | |
| userInput | path | required | string | The human-readable string input that contains (1) stock symbol (2) strike (3) expiration date (4) option side (i.e. put or call). This endpoint will translate the user's input into a valid OCC option symbol. |
GET /v1/options/lookup/{userInput}
/v1/options/quotes/{optionSymbol}
Get a current or historical end of day quote for a single or multiple options contracts. Separate multiple options symbols with a comma.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| format | query | optional | string | The format parameter is used to specify the format for your data. We support JSON and CSV formats. The default format is JSON. |
| optionSymbol | path | required | string | The option symbol (as defined by the OCC) for the option you wish to lookup. Use the current OCC option symbol format, even for historic options that quoted before the format change in 2010. |
| date | query | optional | string | Use to lookup a historical end of day quote from a specific trading day. If no date is specified the quote will be the most current price available during market hours. When the market is closed the quote will be from the last trading day. Accepted date inputs: ISO 8601, unix, spreadsheet. |
| from | query | optional | string | Use to lookup a series of end of day quotes. From is the oldest (leftmost) date to return (inclusive). If from/to is not specified the quote will be the most current price available during market hours. When the market is closed the quote will be from the last trading day. Accepted date inputs: ISO 8601, unix, spreadsheet. |
| to | query | optional | string | Use to lookup a series of end of day quotes. To is the newest (rightmost) date to return (exclusive). If from/to is not specified the quote will be the most current price available during market hours. When the market is closed the quote will be from the last trading day. Accepted date inputs: ISO 8601, unix, spreadsheet. |
| countback | query | optional | integer | Countback will fetch a number of quotes before (to the left of) to If you use from, countback is not required. |
| dateformat | query | optional | string | The dateformat parameter allows you specify the format you wish to receive date and time information in. |
| limit | query | optional | integer | The limit parameter allows you to limit the number of results for a particular API call or override an endpoint’s default limits to get more data. |
| offset | query | optional | integer | The offset parameter is used together with limit to allow you to implement pagination in your application. Offset will allow you to return values starting at a certain value. |
| headers | query | optional | boolean | The headers parameter is used to turn off headers when using CSV output. |
| columns | query | optional | string | The columns parameter is used to limit the results and only request the columns you need. The most common use of this feature is to embed a single numeric result from one of the end points in a spreadsheet cell. |
| human | query | optional | boolean | Use human-readable attribute names in the JSON or CSV output instead of the standard camelCase attribute names. |
GET /v1/options/quotes/{optionSymbol}
/v1/options/strikes/{underlying}
Get a list of current or historical options strikes for an underlying symbol. If no optional parameters are used, the endpoint returns the strikes for every expiration in the chain.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| format | query | optional | string | The format parameter is used to specify the format for your data. We support JSON and CSV formats. The default format is JSON. |
| underlying | path | required | string | The underlying ticker symbol for the options chain you wish to lookup. Ticker Formats: (TICKER, TICKER.EX, EXCHANGE:TICKER) |
| date | query | optional | string | Use to lookup a historical list of strikes from a specific previous trading day. If date is omitted the strikes will be from the current trading day during market hours or from the last trading day when the market is closed. Accepted date inputs: ISO 8601, unix, spreadsheet. |
| expiration | query | optional | string | imit the lookup of strikes to options that expire on a specific expiration date. Accepted date inputs: ISO 8601, unix, spreadsheet. |
| dateformat | query | optional | string | The dateformat parameter allows you specify the format you wish to receive date and time information in. |
| limit | query | optional | integer | The limit parameter allows you to limit the number of results for a particular API call or override an endpoint’s default limits to get more data. |
| offset | query | optional | integer | The offset parameter is used together with limit to allow you to implement pagination in your application. Offset will allow you to return values starting at a certain value. |
| headers | query | optional | boolean | The headers parameter is used to turn off headers when using CSV output. |
| columns | query | optional | string | The columns parameter is used to limit the results and only request the columns you need. The most common use of this feature is to embed a single numeric result from one of the end points in a spreadsheet cell. |
| symbol_lookup | query | optional | boolean | |
| human | query | optional | boolean | Use human-readable attribute names in the JSON or CSV output instead of the standard camelCase attribute names. |
GET /v1/options/strikes/{underlying}
/v1/stocks/bulkcandles/{resolution}
Get bulk candle data for stocks. This endpoint returns bulk daily candle data for multiple stocks.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| format | query | optional | string | The format parameter is used to specify the format for your data. We support JSON and CSV formats. The default format is JSON. |
| resolution | path | required | string | The duration of each candle. Minutely Resolutions: (1, 3, 5, 15, 30, 45, ...) Hourly Resolutions: (H, 1H, 2H, ...) Daily Resolutions: (D, 1D, 2D, ...) Weekly Resolutions: (W, 1W, 2W, ...) Monthly Resolutions: (M, 1M, 2M, ...) Yearly Resolutions:(Y, 1Y, 2Y, ...)') |
| symbol | path | required | string | The company's ticker symbol. If no exchange is specified, by default a US exchange will be assumed. You may embed the exchange in the ticker symbol using the Yahoo Finance or TradingView formats. Ticker Formats: (TICKER, TICKER.EX, EXCHANGE:TICKER) |
| date | query | optional | string | Use to lookup historical candles from a specific trading day. Accepted date inputs: ISO 8601, unix, spreadsheet. |
| from | query | optional | string | The leftmost candle on a chart (inclusive). If you use countback, to is not required. Accepted timestamp inputs: ISO 8601, unix, spreadsheet. |
| to | query | optional | string | The rightmost candle on a chart (not inclusive). Accepted timestamp inputs: ISO 8601, unix, spreadsheet. |
| countback | query | optional | integer | Countback will fetch a number of candles before (to the left of) to If you use from, countback is not required. |
| exchange | query | optional | string | Use to specify the exchange of the ticker. This is useful when you need to specify stock that quotes on several exchanges with the same symbol. You may specify the exchange using the EXCHANGE ACRONYM, MIC CODE, or two digit YAHOO FINANCE EXCHANGE CODE. If no exchange is specified symbols will be matched to US exchanges first. |
| extended | query | optional | boolean | Include extended hours trading sessions when returning intraday candles. Daily resolutions never return extended hours candles. The default is false |
| country | query | optional | string | Use to specify the country of the exchange (not the country of the company) in conjunction with the symbol argument. This argument is useful when you know the ticker symbol and the country of the exchange, but not the exchange code. Use the two digit ISO 3166 country code. If no country is specified, US exchanges will be assumed. |
| adjustsplits | query | optional | boolean | Adjust historical data for for historical splits and reverse splits. Market Data uses the CRSP methodology for adjustment. Daily candles default: true. Intraday candles default: false. |
| adjustdividends | query | optional | boolean | Adjust candles for dividends. Market Data uses the CRSP methodology for adjustment. Daily candles default: true. Intraday candles default: false. |
| dateformat | query | optional | string | The dateformat parameter allows you specify the format you wish to receive date and time information in. |
| limit | query | optional | integer | The limit parameter allows you to limit the number of results for a particular API call or override an endpoint’s default limits to get more data. |
| offset | query | optional | integer | The offset parameter is used together with limit to allow you to implement pagination in your application. Offset will allow you to return values starting at a certain value. |
| headers | query | optional | boolean | The headers parameter is used to turn off headers when using CSV output. |
| columns | query | optional | string | The columns parameter is used to limit the results and only request the columns you need. The most common use of this feature is to embed a single numeric result from one of the end points in a spreadsheet cell. |
| human | query | optional | boolean | Use human-readable attribute names in the JSON or CSV output instead of the standard camelCase attribute names. |
GET /v1/stocks/bulkcandles/{resolution}
/v1/stocks/bulkquotes
Get bulk quote data for stocks. This endpoint returns bulk real time quote data for multiple stocks.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| format | query | optional | string | The format parameter is used to specify the format for your data. We support JSON and CSV formats. The default format is JSON. |
| symbol | path | required | string | The company's ticker symbol. If no exchange is specified, by default a US exchange will be assumed. You may embed the exchange in the ticker symbol using the Yahoo Finance or TradingView formats. Ticker Formats: (TICKER, TICKER.EX, EXCHANGE:TICKER) |
| dateformat | query | optional | string | The dateformat parameter allows you specify the format you wish to receive date and time information in. |
| limit | query | optional | integer | The limit parameter allows you to limit the number of results for a particular API call or override an endpoint's default limits to get more data. |
| offset | query | optional | integer | The offset parameter is used together with limit to allow you to implement pagination in your application. Offset will allow you to return values starting at a certain value. |
| headers | query | optional | boolean | The headers parameter is used to turn off headers when using CSV output. |
| columns | query | optional | string | The columns parameter is used to limit the results and only request the columns you need. The most common use of this feature is to embed a single numeric result from one of the end points in a spreadsheet cell. |
| symbol_lookup | query | optional | boolean | |
| human | query | optional | boolean | Use human-readable attribute names in the JSON or CSV output instead of the standard camelCase attribute names. |
GET /v1/stocks/bulkquotes
/v1/stocks/candles/{resolution}/{symbol}
Get historical price candles for a stock.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| format | query | optional | string | The format parameter is used to specify the format for your data. We support JSON and CSV formats. The default format is JSON. |
| resolution | path | required | string | The duration of each candle. Minutely Resolutions: (1, 3, 5, 15, 30, 45, ...) Hourly Resolutions: (H, 1H, 2H, ...) Daily Resolutions: (D, 1D, 2D, ...) Weekly Resolutions: (W, 1W, 2W, ...) Monthly Resolutions: (M, 1M, 2M, ...) Yearly Resolutions:(Y, 1Y, 2Y, ...)') |
| symbol | path | required | string | The company's ticker symbol. If no exchange is specified, by default a US exchange will be assumed. You may embed the exchange in the ticker symbol using the Yahoo Finance or TradingView formats. Ticker Formats: (TICKER, TICKER.EX, EXCHANGE:TICKER) |
| date | query | optional | string | Use to lookup historical candles from a specific trading day. Accepted date inputs: ISO 8601, unix, spreadsheet. |
| from | query | optional | string | The leftmost candle on a chart (inclusive). If you use countback, to is not required. Accepted timestamp inputs: ISO 8601, unix, spreadsheet. |
| to | query | optional | string | The rightmost candle on a chart (not inclusive). Accepted timestamp inputs: ISO 8601, unix, spreadsheet. |
| countback | query | optional | integer | Countback will fetch a number of candles before (to the left of) to If you use from, countback is not required. |
| exchange | query | optional | string | Use to specify the exchange of the ticker. This is useful when you need to specify stock that quotes on several exchanges with the same symbol. You may specify the exchange using the EXCHANGE ACRONYM, MIC CODE, or two digit YAHOO FINANCE EXCHANGE CODE. If no exchange is specified symbols will be matched to US exchanges first. |
| extended | query | optional | boolean | Include extended hours trading sessions when returning intraday candles. Daily resolutions never return extended hours candles. The default is false |
| country | query | optional | string | Use to specify the country of the exchange (not the country of the company) in conjunction with the symbol argument. This argument is useful when you know the ticker symbol and the country of the exchange, but not the exchange code. Use the two digit ISO 3166 country code. If no country is specified, US exchanges will be assumed. |
| adjustsplits | query | optional | boolean | Adjust historical data for for historical splits and reverse splits. Market Data uses the CRSP methodology for adjustment. Daily candles default: true. Intraday candles default: false. |
| adjustdividends | query | optional | boolean | Adjust candles for dividends. Market Data uses the CRSP methodology for adjustment. Daily candles default: true. Intraday candles default: false. |
| dateformat | query | optional | string | The dateformat parameter allows you specify the format you wish to receive date and time information in. |
| limit | query | optional | integer | The limit parameter allows you to limit the number of results for a particular API call or override an endpoint’s default limits to get more data. |
| offset | query | optional | integer | The offset parameter is used together with limit to allow you to implement pagination in your application. Offset will allow you to return values starting at a certain value. |
| headers | query | optional | boolean | The headers parameter is used to turn off headers when using CSV output. |
| columns | query | optional | string | The columns parameter is used to limit the results and only request the columns you need. The most common use of this feature is to embed a single numeric result from one of the end points in a spreadsheet cell. |
| human | query | optional | boolean | Use human-readable attribute names in the JSON or CSV output instead of the standard camelCase attribute names. |
GET /v1/stocks/candles/{resolution}/{symbol}
/v1/stocks/earnings/{symbol}
Get historical earnings per share data or a future earnings calendar for a stock.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| format | query | optional | string | The format parameter is used to specify the format for your data. We support JSON and CSV formats. The default format is JSON. |
| symbol | path | required | string | The company's ticker symbol. If no exchange is specified, by default a US exchange will be assumed. You may embed the exchange in the ticker symbol using the Yahoo Finance or TradingView formats. Ticker Formats: (TICKER, TICKER.EX, EXCHANGE:TICKER) |
| date | query | optional | string | Retrieve a specific earnings report by date. Accepted timestamp inputs: ISO 8601, unix, spreadsheet. |
| from | query | optional | string | The earliest earnings report to include in the output.If you use countback, from is not required. Accepted timestamp inputs: ISO 8601, unix, spreadsheet. |
| to | query | optional | string | The latest earnings report to include in the output. Accepted timestamp inputs: ISO 8601, unix, spreadsheet. |
| countback | query | optional | integer | Countback will fetch a specific number of earnings reports before to. If you use from, countback is not required. |
| report | query | optional | string | Retrieve a specific earnings report by date and quarter. Example: 2023-Q4. This allows you to retrieve a 4th qurater value without knowing the company's specific fiscal year. |
| dateformat | query | optional | string | The dateformat parameter allows you specify the format you wish to receive date and time information in. |
| limit | query | optional | integer | The limit parameter allows you to limit the number of results for a particular API call or override an endpoint's default limits to get more data. |
| offset | query | optional | integer | The offset parameter is used together with limit to allow you to implement pagination in your application. Offset will allow you to return values starting at a certain value. |
| headers | query | optional | boolean | The headers parameter is used to turn off headers when using CSV output. |
| columns | query | optional | string | The columns parameter is used to limit the results and only request the columns you need. The most common use of this feature is to embed a single numeric result from one of the end points in a spreadsheet cell. |
| human | query | optional | boolean | Use human-readable attribute names in the JSON or CSV output instead of the standard camelCase attribute names. |
GET /v1/stocks/earnings/{symbol}
/v1/stocks/news/{symbol}
Get news for a stock.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| format | query | optional | string | The format parameter is used to specify the format for your data. We support JSON and CSV formats. The default format is JSON. |
| symbol | path | required | string | The company's ticker symbol. If no exchange is specified, by default a US exchange will be assumed. You may embed the exchange in the ticker symbol using the Yahoo Finance or TradingView formats. Ticker Formats: (TICKER, TICKER.EX, EXCHANGE:TICKER) |
| date | query | optional | string | Retrieve a specific earnings report by date. Accepted timestamp inputs: ISO 8601, unix, spreadsheet. |
| from | query | optional | string | The earliest earnings report to include in the output.If you use countback, from is not required. Accepted timestamp inputs: ISO 8601, unix, spreadsheet. |
| to | query | optional | string | The latest earnings report to include in the output. Accepted timestamp inputs: ISO 8601, unix, spreadsheet. |
| countback | query | optional | integer | Countback will fetch a specific number of earnings reports before to. If you use from, countback is not required. |
| report | query | optional | string | Retrieve a specific earnings report by date and quarter. Example: 2023-Q4. This allows you to retrieve a 4th qurater value without knowing the company's specific fiscal year. |
| dateformat | query | optional | string | The dateformat parameter allows you specify the format you wish to receive date and time information in. |
| limit | query | optional | integer | The limit parameter allows you to limit the number of results for a particular API call or override an endpoint's default limits to get more data. |
| offset | query | optional | integer | The offset parameter is used together with limit to allow you to implement pagination in your application. Offset will allow you to return values starting at a certain value. |
| headers | query | optional | boolean | The headers parameter is used to turn off headers when using CSV output. |
| columns | query | optional | string | The columns parameter is used to limit the results and only request the columns you need. The most common use of this feature is to embed a single numeric result from one of the end points in a spreadsheet cell. |
| human | query | optional | boolean | Use human-readable attribute names in the JSON or CSV output instead of the standard camelCase attribute names. |
GET /v1/stocks/news/{symbol}
/v1/stocks/quotes/{symbol}
Get last quote for a stock.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| format | query | optional | string | The format parameter is used to specify the format for your data. We support JSON and CSV formats. The default format is JSON. |
| symbol | path | required | string | The company's ticker symbol. If no exchange is specified, by default a US exchange will be assumed. You may embed the exchange in the ticker symbol using the Yahoo Finance or TradingView formats. Ticker Formats: (TICKER, TICKER.EX, EXCHANGE:TICKER) |
| dateformat | query | optional | string | The dateformat parameter allows you specify the format you wish to receive date and time information in. |
| limit | query | optional | integer | The limit parameter allows you to limit the number of results for a particular API call or override an endpoint's default limits to get more data. |
| offset | query | optional | integer | The offset parameter is used together with limit to allow you to implement pagination in your application. Offset will allow you to return values starting at a certain value. |
| headers | query | optional | boolean | The headers parameter is used to turn off headers when using CSV output. |
| columns | query | optional | string | The columns parameter is used to limit the results and only request the columns you need. The most common use of this feature is to embed a single numeric result from one of the end points in a spreadsheet cell. |
| symbol_lookup | query | optional | boolean | |
| human | query | optional | boolean | Use human-readable attribute names in the JSON or CSV output instead of the standard camelCase attribute names. |
GET /v1/stocks/quotes/{symbol}