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:

OptionWhat happens
OffEvery new value is sent
1 sAt most one value a second
1 minAt most one value a minute (the default)
1 hAt most one value an hour
1 dAt most one value a day
CustomAny 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:

ProxyAlert
SendsEvery value, throttledOnly when a condition matches or an event happens
ConditionNoneUp to 10 comparisons (2 on Free)
MessageThe value as it isYour own text, with values dropped in
SinksOneAs many as you like
HistoryThe last 50 deliveriesEvery 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.