Repository navigation
Event Feed for other applications
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.
For privacy reasons, the system is off by default. To enable it:
- Open your Settings and find the Event Feed section at the bottom
- Enable "Stream events for other programs on this PC"
- 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.
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.1andlocalhost. Any otherHostheader will receive a 403. There is no CORS.
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.
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.
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 |
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 |
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.
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 |
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 |
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 |
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
|
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 |
The run ended and Merframe saved it. Same run shape as arbitration_run_updated, with a final status.
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 |
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.
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
|
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 |
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.