joedursun/client-js

JS client for polygon.io api

polygon.io

Install

npm install --save @polygon.io/client-js

usage

Authentication

• call the desired client with your api key to initialize it

import { polygonClient, restClient, websocketClient } from "@polygon.io/client-js";
const rest = restClient("API KEY");

// you can use the api now

rest.forex
  .previousClose("C:EURUSD")
  .then(/* your success handler */)
  .catch(/* your error handler*/);

REST API

• import all the rest submodule

import { restClient } from "@polygon.io/client-js";

const rest = restClient("api key");

rest.forex.previousClose("C:EURUSD").then(/* your success handler */);

• import a specific submodule

import { referenceClient } from "@polygon.io/client-js";

const reference = referenceClient("api key");

reference.tickers().then(/* your success handler */);

For Launchpad Examples and Usage, see Polygon Launchpad Examples

Websocket

You can get preauthenticated websocket clients for the 3 topics.

import { websocketClient } from "@polygon.io/client-js";

const stocksWS = websocketClient("api key").stocks();

stocksWS.onmessage = ({data}) => {
  const [message] = JSON.parse(data);

  stocksWS.send('{"action":"subscribe", "params":"AM.MSFT,A.MSFT"}');

  switch (message.ev) {
    case "AM":
      // your trade message handler
      break;
    case "A":
      // your trade message handler
      break;
  }
};

stocksWS.send({ action: "subscribe", params: "T.MSFT" });

documentation

• Generate the package documentation

npm run generate-doc