curl --no-buffer --request GET \
--url 'https://api.edgeful.com/live/<market_type>/wip' \
--header 'Authorization: Bearer <api-key>'import requests
url = "https://api.edgeful.com/live/<market_type>/wip"
headers = {"Authorization": "Bearer <api-key>"}
response = requests.get(url, headers=headers, stream=True)
for line in response.iter_lines():
if line:
print(line.decode())const url = "https://api.edgeful.com/live/<market_type>/wip";
const response = await fetch(url, {
method: "GET",
headers: { Authorization: "Bearer <api-key>" },
});
const reader = response.body.getReader();
const decoder = new TextDecoder();
while (true) {
const { done, value } = await reader.read();
if (done) break;
console.log(decoder.decode(value));
}<?php
$ch = curl_init("https://api.edgeful.com/live/<market_type>/wip");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer <api-key>"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, false);
curl_setopt($ch, CURLOPT_BUFFERSIZE, 1);
curl_setopt($ch, CURLOPT_WRITEFUNCTION, function($ch, $data) {
echo $data;
ob_flush();
flush();
return strlen($data);
});
curl_exec($ch);
curl_close($ch);package main
import (
"bufio"
"fmt"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.edgeful.com/live/<market_type>/wip", nil)
req.Header.Set("Authorization", "Bearer <api-key>")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
scanner := bufio.NewScanner(resp.Body)
for scanner.Scan() {
fmt.Println(scanner.Text())
}
}import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.BufferedReader;
import java.io.InputStreamReader;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.edgeful.com/live/<market_type>/wip"))
.header("Authorization", "Bearer <api-key>")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<java.io.InputStream> response = client.send(
request, HttpResponse.BodyHandlers.ofInputStream());
try (BufferedReader reader = new BufferedReader(
new InputStreamReader(response.body()))) {
reader.lines().forEach(System.out::println);
}require "net/http"
require "uri"
uri = URI("https://api.edgeful.com/live/<market_type>/wip")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer <api-key>"
Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
http.request(request) do |response|
response.read_body do |chunk|
print chunk
end
end
end{
"detail": {
"detail": "Live data is not available on your current plan. Please upgrade to the Pro or All Access plan to gain access.",
"code": "live_data_not_allowed"
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}live wip stream
live stream of What’s in Play data for all tickers in the requested market and session. sends the current data immediately on connect, then pushes updates as market data changes. each event is a JSON object keyed by ticker symbol, with per-report analysis nested under each ticker. supports optional ticker filtering, report customization variants, and custom session windows for futures. an API key holds one open stream at a time; a stream that loses its slot to a newer one on the same key sends a final event with stream_status superseded and closes. the stream is always gzip-compressed, many times smaller; browsers and most HTTP libraries (requests, httpx, aiohttp, fetch) decompress it transparently. a client on Python’s urllib receives the gzip bytes with an X-Stream-Encoding: gzip header instead of Content-Encoding, and must gunzip the stream itself (a streaming zlib.decompressobj(16 + zlib.MAX_WBITS)), or switch to a library that decodes.
every report object carries session_date, an ISO date (YYYY-MM-DD): the session day its live values were computed for, in the session’s own timezone (America/New_York for NY, Europe/London for LONDON, Asia/Tokyo for ASIA, the requested timezone for a custom window). a session that crosses midnight belongs to the day it closes into. after a session closes, its final values stay on the stream with that session’s session_date until the report is computed again, so compare session_date with the day you expect instead of inferring it from market_status or report_status. session_date does not date the historical block, and a report without it has an unknown session day.
market_status is a top-level field that follows the session’s clock:
pre market: before the session’s open, more than two hours away.pre market active: within two hours before the open. for the standard sessions, the reports that can be computed before the open are recomputed withpre_market: trueand the rest become emptyformingplaceholders withforms_at_open: true.market hours: between the open and the close. reports update live.post market: after the close, until midnight in the session’s timezone. values settle shortly after the close.weekend: the market is closed for the week (saturday and sunday for stocks; friday 17:00 to sunday 18:00 America/New_York for futures).
once a session’s values have settled, nothing is recomputed in post market, weekend or pre market: reports keep the values last computed, normally the last session’s final values, each with its own session_date. for market_type=all, market_status is the more active of the two markets’ statuses. a custom-session stream opened in one of those three states sends market_status without reports until the session leaves them.
report_status is on each report and describes its setup within the session named by session_date:
in_play: the setup is active and has not resolved.forming: the window that defines the setup has not closed yet, or the session has not opened.completed: the setup resolved, for example the gap filled.not_in_play: the setup’s conditions are not met, or there is not enough data.
report_status says nothing about whether the values are from the current session: completed does not mean stale and in_play does not mean live. use session_date for that.
curl --no-buffer --request GET \
--url 'https://api.edgeful.com/live/<market_type>/wip' \
--header 'Authorization: Bearer <api-key>'import requests
url = "https://api.edgeful.com/live/<market_type>/wip"
headers = {"Authorization": "Bearer <api-key>"}
response = requests.get(url, headers=headers, stream=True)
for line in response.iter_lines():
if line:
print(line.decode())const url = "https://api.edgeful.com/live/<market_type>/wip";
const response = await fetch(url, {
method: "GET",
headers: { Authorization: "Bearer <api-key>" },
});
const reader = response.body.getReader();
const decoder = new TextDecoder();
while (true) {
const { done, value } = await reader.read();
if (done) break;
console.log(decoder.decode(value));
}<?php
$ch = curl_init("https://api.edgeful.com/live/<market_type>/wip");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer <api-key>"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, false);
curl_setopt($ch, CURLOPT_BUFFERSIZE, 1);
curl_setopt($ch, CURLOPT_WRITEFUNCTION, function($ch, $data) {
echo $data;
ob_flush();
flush();
return strlen($data);
});
curl_exec($ch);
curl_close($ch);package main
import (
"bufio"
"fmt"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.edgeful.com/live/<market_type>/wip", nil)
req.Header.Set("Authorization", "Bearer <api-key>")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
scanner := bufio.NewScanner(resp.Body)
for scanner.Scan() {
fmt.Println(scanner.Text())
}
}import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.BufferedReader;
import java.io.InputStreamReader;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.edgeful.com/live/<market_type>/wip"))
.header("Authorization", "Bearer <api-key>")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<java.io.InputStream> response = client.send(
request, HttpResponse.BodyHandlers.ofInputStream());
try (BufferedReader reader = new BufferedReader(
new InputStreamReader(response.body()))) {
reader.lines().forEach(System.out::println);
}require "net/http"
require "uri"
uri = URI("https://api.edgeful.com/live/<market_type>/wip")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer <api-key>"
Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
http.request(request) do |response|
response.read_body do |chunk|
print chunk
end
end
end{
"detail": {
"detail": "Live data is not available on your current plan. Please upgrade to the Pro or All Access plan to gain access.",
"code": "live_data_not_allowed"
}
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
Path Parameters
Query Parameters
Response
Successful Response
Was this page helpful?