Delivery
Proxies: forward a stream to a sink
A proxy sends the values of one stream to a sink as often as you choose: what it sends, the throttle, proxy or alert.
3 min readUpdated
A proxy forwards the values of one stream to one sink, unchanged and as often as you choose. Use it when you want the numbers themselves, not a signal: the BTC price in your chat every hour, a funding rate into your server every minute.
Throttle
A new proxy has three fields: a name, the stream and the sink. Then you choose Send at most once per:
| Option | What happens |
|---|---|
| Off | Every new value is sent |
| 1 s | At most one value a second |
| 1 min | At most one value a minute (the default) |
| 1 h | At most one value an hour |
| 1 d | At most one value a day |
| Custom | Any period up to one day |
The first value goes out right away; the values that come in during the rest of the period are skipped. With 1 h on the Binance BTC price, which updates every second, you get one price an hour instead of 3,600.
Faster than once a minute (Off and 1 s) is on Pro. On Free, the shortest period is 1 minute. The default is 1 minute because most prices update every few seconds, and a chat that gets a message per second quickly becomes useless.
Proxy or alert
Both send messages to a sink. They answer different questions:
| Proxy | Alert | |
|---|---|---|
| Sends | Every value, throttled | Only when a condition matches or an event happens |
| Condition | None | Up to 10 comparisons (2 on Free) |
| Message | The value as it is | Your own text, with values dropped in |
| Sinks | One | As many as you like |
| History | The last 50 deliveries | Every firing, with all values |
Pick a proxy for a steady feed of a number: a price report into Telegram, a value into your own dashboard through a webhook.
Pick an alert when you only want to hear about something: a level crossed, a new listing. An alert with On every new value (Pro) also sends each update, but lets you write the message yourself.
Any stream can go through a proxy, including the events of one of your alerts: forward them to a second sink without changing the alert.
What the sink gets
Each value arrives as a small JSON object:
{"stream": "atom:binance.miniticker:BTCUSDT:close", "value": 100250.5, "ts": 1794687657086}
stream: which stream the value is from.value: the value itself, a number or a text.ts: when it was measured, in milliseconds since 1970 (UTC).
A webhook receives this as the request body, signed like every webhook request. In Telegram it arrives as the same JSON in a message.
The proxy's page lists its latest deliveries, so you can check what went out and when.
FAQ
How do I get the BTC price in Telegram every hour?
Create a proxy with the BTC price stream, your Telegram sink and the throttle set to 1 h.
Why can't I pick "Off" or "1 s"?
Sending more often than once a minute is on Pro. On Free, choose 1 minute or slower.
Can a proxy send to several sinks?
No, one proxy has one sink. Create a proxy for each sink, or use an alert, which can send to many.
How many proxies can I have?
One on Free and 30 on Pro.