Skip to content

Event Feed for other applications

Luna edited this page Nov 12, 2026 · 5 revisions

Merframe can stream it's events to other programs on the PC. This could be Stream deck plugins, your own overlay, or scripts that act upon your trades. If it can read a URL, it can hook into the event system.

Contents

Turning it on

For privacy reasons, the system is off by default. To enable it:

  1. Open your Settings and find the Event Feed section at the bottom
  2. Enable "Stream events for other programs on this PC"
  3. Confirm that the hint below the port field (can be left on the default) says Streaming at http://127.0.0.1:28005/events

If there are any errors, you can try to change the port or run Merframe as administrator/sudo.

How it works

The event system uses server-sent events (SSE) at http://127.0.0.1:<port>/events. You can connect with a GET request and read the data: lines while the connection is open. Every line is a JSON object:

data: {"event":"inventory_updated","data":{"mr":14,"plat":120,"credits":50000,"endo":3000,"ducats":40,"changes":2}}

The key event is the name of the event, the key data is the payload of that event. Events that do not have a payload do not have a data key.

Some more details:

  • The first thing you get is a status, so you may act upon current information.
  • Older events are not replayed to new connections.
  • Merframe keeps up to 64 events for slow clients. If you fall further behind, you will lose data.
  • The stream may be ended application-side if the feature is turned off, the port is changed, or the application is closed.
  • We serve on 127.0.0.1 and localhost. Any other Host header will receive a 403. There is no CORS.

Privacy

The event system is meant for things you'd put on a second screen, not for giving away your account.

Thus we by default exclude account name, the warframe.market account, game process ID, path to log files, trade partner names, or new chats.

The feed has the same pen and paper rule as Merframe itself, we only send data Merframe also displays.

Minimal python example

import json
import urllib.request

with urllib.request.urlopen("http://127.0.0.1:28005/events") as feed:
    for line in feed:
        if line.startswith(b"data:"):
            event = json.loads(line[5:])
            print(event["event"], event.get("data"))

Run it with the game open and sync your inventory by leaving a relay. You'll see a status immediately, then whatever happens next when it happens.

Field names and event names are snake_case. Times are ISO 8601 in UTC, like 2026-10-26T18:04:11Z. A field marked "or null" may be null.

Events

status

Sent on connect and whenever one of these changes.

Field Type Meaning
game_detected bool Warframe is running
scanning bool Merframe is reading the game
log_attached bool Merframe is following EE.log
last_sync_at time or null last inventory sync
world_state_at time or null last worldState fetch
trades_remaining integer or null daily trades you have left

inventory_updated

A new inventory arrived from the game.

Field Type Meaning
mr integer mastery rank
plat integer Platinum
credits integer Credits
endo integer Endo
ducats integer Ducats
changes integer number of item changes compared to the previous inventory

relic_reward_screen

The relic reward choice screen is open and Merframe ranked the options.

Field Type Meaning
relic string or null the relic you opened, if known
screen.ranked list the rewards on screen, best first
screen.account object or null your plat and ducats

Every entry in ranked has item (name, unique_name, prime, and when known ducats, market_slug, image_name, vault as vaulted, available or unknown), favourite, best (the one Merframe highlights), plat and set_plat (or null), ownership (owned, needed, needed_for_set, parent_owned, or null) and components for a set.

I heavily recommend looking at a dump of this before deciding on how to use the information this has.

trade_completed

A trade went through in game. The trade partner's name is not included for privacy reasons.

Field Type Meaning
at time when
trade.offered list items given name, count, rank (or null)
trade.received list items received, same shape
trade.plat integer Platinum exchanged, positive when received, negative when paid

fissure_alert

A fissure matched one of the fissure notification filters.

Field Type Meaning
fissure.node_id string the game's node id
fissure.planet string or null planet
fissure.node_name string or null node name
fissure.mission_name string mission name as shown in game
fissure.mission_type string mission type
fissure.faction string or null faction
fissure.tier string relic tier, Lith to Omnia
fissure.steel_path bool Steel Path fissure
fissure.is_storm bool Void Storm (Railjack)
fissure.levels [integer, integer] or null enemy level range
fissure.expiry time when it ends
fissure.remaining_secs integer seconds until expiry

world_reward_alert

An alert, invasion or event offers something the user wants to be notified of.

Field Type Meaning
reward.key string stable id of this offer
reward.source string Alert, Invasion or Event
reward.label string the reward, as shown in game
reward.image_name string or null image file name on cdn.warframestat.us
reward.location string or null "Planet, Node (Type)"
reward.mission string or null mission description
reward.side string or null the invasion side to run
reward.requirement string or null what you have to do for it
reward.expiry time or null when the offer ends

arbitration_alert

An Arbitration that is marked or that matches a filter is about to start or has started.

Field Type Meaning
alert.at_start bool sent at the start, otherwise it's the advance notice
alert.minutes_ahead integer minutes until the start, 0 at the start
alert.reminder bool a reminder was set for this
alert.slot.id string stable slot id
alert.slot.node_id string the game's node id
alert.slot.node string node name
alert.slot.planet string or null planet
alert.slot.mission_type string or null mission type
alert.slot.faction string or null faction
alert.slot.tier string S, A, B, C, D or F
alert.slot.starts time start
alert.slot.ends time end
alert.slot.favourite bool node is a favourite
alert.slot.matches bool slot matches a filter
alert.slot.reminder bool same as alert.reminder

arbitration_run_updated

The currently played Arbitration progressed in some form. Can be a reward rotation, a wave, a drone spawn or a change in enemy counts. This is what the Live Arbitration overlay draws. The run's status is recording until it ends.

Field Type Meaning
run.id string stable id of the run
run.status string recording, completed, failed, aborted, ended or interrupted
run.source string live or import
run.planet, run.node, run.node_id, run.mission_type string or null where
run.started_at time or null when the run started
run.duration_secs number seconds since the run started
run.complete_capture bool Merframe saw the run from its start
run.rotations list index, at_secs, duration_secs (or null) per rotation
run.reward_cycles integer or null rotations completed
run.drone_spawns, run.enemy_spawns, run.peak_live_agents integer or null spawn counts
run.host bool or null user hosted the squad
run.boosters, run.notes, run.waves, run.samples lists see the schema if needed, complex

arbitration_run_recorded

The run ended and Merframe saved it. Same run shape as arbitration_run_updated, with a final status.

timer_alert

A world cycle with notifications enabled is about to change.

Field Type Meaning
name string Earth, Cetus, Orb Vallis, Cambion Drift, Duviri or Zariman
next_state string the state that comes next: day, night, warm, cold, fass, vome, sorrow, fear, joy, anger, envy, corpus, grineer
ends_at time when the current state ends
remaining_secs integer seconds until then

reset_checklist_row_changed

A row/entry of the Reset Checklist changed (via progress, finish, or reset). This isn't sent for resets the player hasn't unlocked yet.

Field Type Meaning
id string stable id of the row, like sortie or archon_hunt
name string the row, as shown in Merframe
group string daily, weekly or sortie
done bool done for this reset
progress.kind string counted, remaining, yes_no, manual or unknown
progress.done, progress.total integer only for counted, how far along the player is
progress.left, progress.cap integer only for remaining, how much the player can still get or use
progress.id, progress.checked string, bool only for manual, for manually checked progress

Resets are not a separate event, but just a change from i.E. done=true to done=false.

Hidden entries or settings do not change what is sent here.

market_auto_closed

Merframe closed a warframe.market order.

Field Type Meaning
item string item name
quantity integer quantity that was listed
kind string sell, buy or auction

Events without a data key

These only tell you something refreshed. Ask Merframe's UI, or your own data source, for the details.

Event Meaning
trades_updated the trade history changed
world_state_updated a new worldState was fetched
riven_data_updated riven price data was refreshed
prices_updated item prices were refreshed
favourite_updated you changed a favourite

Schema

The exact shapes are generated from the Rust types into specs/sse.schema.json. The schema is always right and if this page says something else this page needs an edit.

New events are added, existing fields are not removed without a note in the release. Unknown event names are to be ignored and should not result in a user-facing error.

Clone this wiki locally