Price Pusher Control API
This page provides documentation for the Price Pusher's control API. You can use these endpoints to manage the price feeds and the overall behavior of the service.
Actions Overview
These are the main operations you can perform on the price feeds.
- Start Publishing: Resumes sending price updates to the blockchain for one or all markets.
- Stop Publishing: Pauses sending price updates to the blockchain. The service also stops fetching prices automatically until it is started again.
- Freeze Price: Stops fetching live prices from the exchange for a specific market. The service will keep publishing the last known or manually set price (via the
/set-price endpoint). This is useful when you want to set a manual price.
- Unfreeze Price: Resumes fetching live prices from the exchange for a specific market.
- Set Price: Sets a manual price for a market. This price will be used for all future updates until you unfreeze the market. This action requires the market to be frozen first.
- Send Price: Sets a manual price and immediately publishes it to the blockchain. This is a one-time, instant update.
Available Symbols
The following market symbols are configured:
ALL (Use this to target all symbols at once)1000PEPEUSDTASTERUSDTBNBUSDTBTCUSDTDOGEUSDTETHUSDTHYPEUSDTPUMPUSDTSOLUSDTSUIUSDTTRUMPUSDTXPLUSDTZECUSDT
API Endpoints
All endpoints are available under the /api/v1 path.
GET /action/start/SYMBOL
GET /action/start
Starts publishing prices for the specified SYMBOL. Omit the symbol to start publishing for all markets.
GET /action/stop/SYMBOL
GET /action/stop
Stops publishing prices for the specified SYMBOL. Omit the symbol to stop publishing for all markets.
GET /action/freeze/SYMBOL
GET /action/freeze
Freezes the price for SYMBOL at its last known value. Live price fetching is paused.
GET /action/unfreeze/SYMBOL
GET /action/unfreeze
Resumes live price fetching for SYMBOL.
GET /set-price/SYMBOL/PRICE
Sets a manual price for a frozen SYMBOL. The PRICE should be a decimal number (e.g., 71000.50). The same PRICE will be used for all future updates until unfreeze.
GET /send-price/SYMBOL/PRICE
Sets a manual price for SYMBOL and immediately publishes it.
GET /set-poll-interval-ms/MILLISECONDS
Updates how often the service polls for new prices, in milliseconds. Minimum is 50ms.
GET /status
Returns the current status of all markets, including their prices, publishing state, and poll interval.