snaptrade-typescript-sdk 9.0.166 → 9.0.167

package/README.md

@@ -6,7 +6,7 @@
 
 Connect brokerage accounts to your app for live positions and trading
 
-[![npm](https://img.shields.io/badge/npm-v9.0.166-blue)](https://www.npmjs.com/package/snaptrade-typescript-sdk/v/9.0.166)
+[![npm](https://img.shields.io/badge/npm-v9.0.167-blue)](https://www.npmjs.com/package/snaptrade-typescript-sdk/v/9.0.167)
 [![More Info](https://img.shields.io/badge/More%20Info-Click%20Here-orange)](https://snaptrade.com/)
 
 </div>
@@ -46,6 +46,7 @@ Connect brokerage accounts to your app for live positions and trading
   * [`snaptrade.experimentalEndpoints.getUserAccountOrderDetailV2`](#snaptradeexperimentalendpointsgetuseraccountorderdetailv2)
   * [`snaptrade.experimentalEndpoints.getUserAccountOrdersV2`](#snaptradeexperimentalendpointsgetuseraccountordersv2)
   * [`snaptrade.experimentalEndpoints.getUserAccountRecentOrdersV2`](#snaptradeexperimentalendpointsgetuseraccountrecentordersv2)
+  * [`snaptrade.options.getOptionQuote`](#snaptradeoptionsgetoptionquote)
   * [`snaptrade.options.getOptionsChain`](#snaptradeoptionsgetoptionschain)
   * [`snaptrade.options.listOptionHoldings`](#snaptradeoptionslistoptionholdings)
   * [`snaptrade.referenceData.getCurrencyExchangeRatePair`](#snaptradereferencedatagetcurrencyexchangeratepair)
@@ -1360,6 +1361,46 @@ Defaults to true. Indicates if request should fetch only executed orders. Set to
 ---
 
 
+### `snaptrade.options.getOptionQuote`<a id="snaptradeoptionsgetoptionquote"></a>
+
+Returns a real-time quote for a single option contract. The option contract is specified using an OCC-formatted symbol.
+
+OCC format: `AAPL  251219C00150000` (underlying padded to 6 characters with spaces, followed by date, put/call, and strike).
+
+
+#### 🛠️ Usage<a id="🛠️-usage"></a>
+
+```typescript
+const getOptionQuoteResponse = await snaptrade.options.getOptionQuote({
+  userId: "snaptrade-user-123",
+  userSecret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
+  symbol: "AAPL  251219C00150000",
+});
+```
+
+#### ⚙️ Parameters<a id="⚙️-parameters"></a>
+
+##### userId: `string`<a id="userid-string"></a>
+
+##### userSecret: `string`<a id="usersecret-string"></a>
+
+##### symbol: `string`<a id="symbol-string"></a>
+
+The OCC-formatted option symbol.
+
+#### 🔄 Return<a id="🔄-return"></a>
+
+[OptionQuote](./models/option-quote.ts)
+
+#### 🌐 Endpoint<a id="🌐-endpoint"></a>
+
+`/marketData/options/quotes` `GET`
+
+[🔙 **Back to Table of Contents**](#table-of-contents)
+
+---
+
+
 ### `snaptrade.options.getOptionsChain`<a id="snaptradeoptionsgetoptionschain"></a>
 
 Returns the option chain for the specified symbol in the specified account.

package/dist/api/options-api-generated.d.ts

@@ -2,12 +2,23 @@ import { AxiosPromise, AxiosInstance, AxiosRequestConfig } from 'axios';
 import { Configuration } from '../configuration';
 import { RequestArgs, BaseAPI } from '../base';
 import { OptionChainInner } from '../models';
+import { OptionQuote } from '../models';
 import { OptionsPosition } from '../models';
 /**
  * OptionsApi - axios parameter creator
  * @export
  */
 export declare const OptionsApiAxiosParamCreator: (configuration?: Configuration) => {
+    /**
+     * Returns a real-time quote for a single option contract. The option contract is specified using an OCC-formatted symbol.  OCC format: `AAPL  251219C00150000` (underlying padded to 6 characters with spaces, followed by date, put/call, and strike).
+     * @summary Get option quote
+     * @param {string} userId
+     * @param {string} userSecret
+     * @param {string} symbol The OCC-formatted option symbol.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getOptionQuote: (userId: string, userSecret: string, symbol: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Returns the option chain for the specified symbol in the specified account.
      * @summary Get the options chain for a symbol
@@ -35,6 +46,14 @@ export declare const OptionsApiAxiosParamCreator: (configuration?: Configuration
  * @export
  */
 export declare const OptionsApiFp: (configuration?: Configuration) => {
+    /**
+     * Returns a real-time quote for a single option contract. The option contract is specified using an OCC-formatted symbol.  OCC format: `AAPL  251219C00150000` (underlying padded to 6 characters with spaces, followed by date, put/call, and strike).
+     * @summary Get option quote
+     * @param {OptionsApiGetOptionQuoteRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getOptionQuote(requestParameters: OptionsApiGetOptionQuoteRequest, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<OptionQuote>>;
     /**
      * Returns the option chain for the specified symbol in the specified account.
      * @summary Get the options chain for a symbol
@@ -57,6 +76,14 @@ export declare const OptionsApiFp: (configuration?: Configuration) => {
  * @export
  */
 export declare const OptionsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
+    /**
+     * Returns a real-time quote for a single option contract. The option contract is specified using an OCC-formatted symbol.  OCC format: `AAPL  251219C00150000` (underlying padded to 6 characters with spaces, followed by date, put/call, and strike).
+     * @summary Get option quote
+     * @param {OptionsApiGetOptionQuoteRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    getOptionQuote(requestParameters: OptionsApiGetOptionQuoteRequest, options?: AxiosRequestConfig): AxiosPromise<OptionQuote>;
     /**
      * Returns the option chain for the specified symbol in the specified account.
      * @summary Get the options chain for a symbol
@@ -74,6 +101,31 @@ export declare const OptionsApiFactory: (configuration?: Configuration, basePath
      */
     listOptionHoldings(requestParameters: OptionsApiListOptionHoldingsRequest, options?: AxiosRequestConfig): AxiosPromise<Array<OptionsPosition>>;
 };
+/**
+ * Request parameters for getOptionQuote operation in OptionsApi.
+ * @export
+ * @interface OptionsApiGetOptionQuoteRequest
+ */
+export type OptionsApiGetOptionQuoteRequest = {
+    /**
+    *
+    * @type {string}
+    * @memberof OptionsApiGetOptionQuote
+    */
+    readonly userId: string;
+    /**
+    *
+    * @type {string}
+    * @memberof OptionsApiGetOptionQuote
+    */
+    readonly userSecret: string;
+    /**
+    * The OCC-formatted option symbol.
+    * @type {string}
+    * @memberof OptionsApiGetOptionQuote
+    */
+    readonly symbol: string;
+};
 /**
  * Request parameters for getOptionsChain operation in OptionsApi.
  * @export
@@ -137,6 +189,15 @@ export type OptionsApiListOptionHoldingsRequest = {
  * @extends {BaseAPI}
  */
 export declare class OptionsApiGenerated extends BaseAPI {
+    /**
+     * Returns a real-time quote for a single option contract. The option contract is specified using an OCC-formatted symbol.  OCC format: `AAPL  251219C00150000` (underlying padded to 6 characters with spaces, followed by date, put/call, and strike).
+     * @summary Get option quote
+     * @param {OptionsApiGetOptionQuoteRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof OptionsApiGenerated
+     */
+    getOptionQuote(requestParameters: OptionsApiGetOptionQuoteRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<OptionQuote, any>>;
     /**
      * Returns the option chain for the specified symbol in the specified account.
      * @summary Get the options chain for a symbol

package/dist/api/options-api-generated.js

@@ -35,6 +35,63 @@ const requestBeforeHook_1 = require("../requestBeforeHook");
  */
 const OptionsApiAxiosParamCreator = function (configuration) {
     return {
+        /**
+         * Returns a real-time quote for a single option contract. The option contract is specified using an OCC-formatted symbol.  OCC format: `AAPL  251219C00150000` (underlying padded to 6 characters with spaces, followed by date, put/call, and strike).
+         * @summary Get option quote
+         * @param {string} userId
+         * @param {string} userSecret
+         * @param {string} symbol The OCC-formatted option symbol.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getOptionQuote: (userId, userSecret, symbol, options = {}) => __awaiter(this, void 0, void 0, function* () {
+            // verify required parameter 'userId' is not null or undefined
+            (0, common_1.assertParamExists)('getOptionQuote', 'userId', userId);
+            // verify required parameter 'userSecret' is not null or undefined
+            (0, common_1.assertParamExists)('getOptionQuote', 'userSecret', userSecret);
+            // verify required parameter 'symbol' is not null or undefined
+            (0, common_1.assertParamExists)('getOptionQuote', 'symbol', symbol);
+            const localVarPath = `/marketData/options/quotes`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'GET' }, baseOptions), options);
+            const localVarHeaderParameter = configuration && !(0, common_1.isBrowser)() ? { "User-Agent": configuration.userAgent } : {};
+            const localVarQueryParameter = {};
+            // authentication PartnerClientId required
+            yield (0, common_1.setApiKeyToObject)({ object: localVarQueryParameter, key: "clientId", keyParamName: "clientId", configuration });
+            // authentication PartnerSignature required
+            yield (0, common_1.setApiKeyToObject)({ object: localVarHeaderParameter, key: "Signature", keyParamName: "signature", configuration });
+            // authentication PartnerTimestamp required
+            yield (0, common_1.setApiKeyToObject)({ object: localVarQueryParameter, key: "timestamp", keyParamName: "timestamp", configuration });
+            if (userId !== undefined) {
+                localVarQueryParameter['userId'] = userId;
+            }
+            if (userSecret !== undefined) {
+                localVarQueryParameter['userSecret'] = userSecret;
+            }
+            if (symbol !== undefined) {
+                localVarQueryParameter['symbol'] = symbol;
+            }
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            (0, requestBeforeHook_1.requestBeforeHook)({
+                queryParameters: localVarQueryParameter,
+                requestConfig: localVarRequestOptions,
+                path: localVarPath,
+                configuration,
+                pathTemplate: '/marketData/options/quotes',
+                httpMethod: 'GET'
+            });
+            (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
+            return {
+                url: (0, common_1.toPathString)(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
         /**
          * Returns the option chain for the specified symbol in the specified account.
          * @summary Get the options chain for a symbol
@@ -161,6 +218,19 @@ exports.OptionsApiAxiosParamCreator = OptionsApiAxiosParamCreator;
 const OptionsApiFp = function (configuration) {
     const localVarAxiosParamCreator = (0, exports.OptionsApiAxiosParamCreator)(configuration);
     return {
+        /**
+         * Returns a real-time quote for a single option contract. The option contract is specified using an OCC-formatted symbol.  OCC format: `AAPL  251219C00150000` (underlying padded to 6 characters with spaces, followed by date, put/call, and strike).
+         * @summary Get option quote
+         * @param {OptionsApiGetOptionQuoteRequest} requestParameters Request parameters.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getOptionQuote(requestParameters, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.getOptionQuote(requestParameters.userId, requestParameters.userSecret, requestParameters.symbol, options);
+                return (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration);
+            });
+        },
         /**
          * Returns the option chain for the specified symbol in the specified account.
          * @summary Get the options chain for a symbol
@@ -197,6 +267,16 @@ exports.OptionsApiFp = OptionsApiFp;
 const OptionsApiFactory = function (configuration, basePath, axios) {
     const localVarFp = (0, exports.OptionsApiFp)(configuration);
     return {
+        /**
+         * Returns a real-time quote for a single option contract. The option contract is specified using an OCC-formatted symbol.  OCC format: `AAPL  251219C00150000` (underlying padded to 6 characters with spaces, followed by date, put/call, and strike).
+         * @summary Get option quote
+         * @param {OptionsApiGetOptionQuoteRequest} requestParameters Request parameters.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getOptionQuote(requestParameters, options) {
+            return localVarFp.getOptionQuote(requestParameters, options).then((request) => request(axios, basePath));
+        },
         /**
          * Returns the option chain for the specified symbol in the specified account.
          * @summary Get the options chain for a symbol
@@ -227,6 +307,17 @@ exports.OptionsApiFactory = OptionsApiFactory;
  * @extends {BaseAPI}
  */
 class OptionsApiGenerated extends base_1.BaseAPI {
+    /**
+     * Returns a real-time quote for a single option contract. The option contract is specified using an OCC-formatted symbol.  OCC format: `AAPL  251219C00150000` (underlying padded to 6 characters with spaces, followed by date, put/call, and strike).
+     * @summary Get option quote
+     * @param {OptionsApiGetOptionQuoteRequest} requestParameters Request parameters.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof OptionsApiGenerated
+     */
+    getOptionQuote(requestParameters, options) {
+        return (0, exports.OptionsApiFp)(this.configuration).getOptionQuote(requestParameters, options).then((request) => request(this.axios, this.basePath));
+    }
     /**
      * Returns the option chain for the specified symbol in the specified account.
      * @summary Get the options chain for a symbol