This app continuously monitors UMA Optimistic Oracle contract proposals and sends notifications based on Polymarket API information.
The Polymarket notifier looks for ProposePrice events related to the Polymarket contracts and uses the Polymarket API to fetch all active contract market prices. It compares proposed prices against the Polymarket API and notifies the user through a logging mechanism that can forward an alert to Slack or any other configured transport mechanism. Notified proposals are stored on Google Datastore, so on repeated runs the application does not notify the same proposal.
The Polymarket notifier uses the following environment variables:
-
CUSTOM_NODE_URL
is a Polygon (chain id 137) network node endpoint. -
NOTIFIER_CONFIG
is a JSON object containing-application specific parameters:-
minAcceptedPrice
determines if an alert should be sent at the time of a proposal based on the price value returned from the Polymarket API. The default is set to 0.99, meaning when a price is proposed it requires the API price to be greater than 0.99 or an alert will be sent. -
minMarketLiquidity
Minimum market liquidity that determines if alert is sent. -
minMarketVolume
Minimum market volume that determines if alert is sent. -
apiEndpoint
sets API to fetch Polymarket contract information, defaulting to https://strapi-matic.poly.market/markets
-
-
POLLING_DELAY
is value in seconds for the delay between consecutive runs, defaults to 10 minutes. If set to 0 then running in serverless mode will exit after the loop. -
BOT_IDENTIFIER
identifies the application name in the logs. -
ERROR_RETRIES
is the number of times to retry failed operation (e.g. due to API not responding). It defaults to 3 re-tries on error within the execution loop. -
ERROR_RETRIES_TIMEOUT
is time in seconds between re-tries, defaulting to 1 second. -
SLACK_CONFIG
is a JSON object containingdefaultWebHookUrl
for the default Slack webhook URL andescalationPathWebhookUrls
being an object with webhook URLs for particular Slack channel routing. -
GOOGLE_APPLICATION_CREDENTIALS
points to Google Cloud Platform service account key file to access Google Datastore. This is only required when running the application locally.
The simplest way to run the Polymarket monitor bot is from UMA protocol repository run (if running locally, make sure you have GOOGLE_APPLICATION_CREDENTIALS
as an environment variable):
CUSTOM_NODE_URL=https://your.node.url.io yarn polymarket-notifier --network polygon-matic