Temporal alpha decomposition for a trader
curl --request GET \
--url http://localhost:3101/api/traders/{address}/temporalimport requests
url = "http://localhost:3101/api/traders/{address}/temporal"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('http://localhost:3101/api/traders/{address}/temporal', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "3101",
CURLOPT_URL => "http://localhost:3101/api/traders/{address}/temporal",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://localhost:3101/api/traders/{address}/temporal"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://localhost:3101/api/traders/{address}/temporal")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:3101/api/traders/{address}/temporal")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"address": "<string>",
"analysed": true,
"modes": {},
"partitions": {},
"classification": {},
"caveats": [
"<string>"
],
"age_s": 123
}{
"error": "invalid_address",
"detail": "<string>"
}{
"address": "<string>",
"analysed": false,
"error": "not_analysed",
"detail": "<string>",
"methodology_url": "<string>",
"engine_unreachable": "<string>"
}Public HTTP endpoints
Temporal decomposition
Where in time a trader’s alpha lives — the question a headline Sharpe cannot answer.
GET
/
api
/
traders
/
{address}
/
temporal
Temporal alpha decomposition for a trader
curl --request GET \
--url http://localhost:3101/api/traders/{address}/temporalimport requests
url = "http://localhost:3101/api/traders/{address}/temporal"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('http://localhost:3101/api/traders/{address}/temporal', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "3101",
CURLOPT_URL => "http://localhost:3101/api/traders/{address}/temporal",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://localhost:3101/api/traders/{address}/temporal"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://localhost:3101/api/traders/{address}/temporal")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:3101/api/traders/{address}/temporal")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"address": "<string>",
"analysed": true,
"modes": {},
"partitions": {},
"classification": {},
"caveats": [
"<string>"
],
"age_s": 123
}{
"error": "invalid_address",
"detail": "<string>"
}{
"address": "<string>",
"analysed": false,
"error": "not_analysed",
"detail": "<string>",
"methodology_url": "<string>",
"engine_unreachable": "<string>"
}Addressed by trader:
/api/traders/{address}/temporal, not /api/wallets/{address}/temporal.What it answers
A headline Sharpe ratio cannot distinguish a trader with genuine entry timing from one who simply held through a favourable regime. This decomposition separates them by attributing realized P&L across time partitions and testing whether the concentration is real.Two attribution modes
realization
Attributes P&L to when the position was closed. Answers “when did the money land”.
exposure
Attributes P&L across the life of the position. Answers “when was the risk held”.
?mode=.
Three partitions
session, weekpart, and hour_of_day. Pass ?partition= to trim the tables to one.
The window definitions, the classification, and the caveats are always included even when you filter, because a table without them is a number without its method.
Every label needs a p-value
The module refuses to classify rather than guessing. Every style label requires a permutation p-value as well as a magnitude.A 40-trade account concentrates by accident. “Your top trader is a funding arbitrageur” is a claim about a named stranger, and it should not be made on a pattern that random reshuffling reproduces.
404 is not a finding
{
"analysed": false,
"error": "not_analysed",
"detail": "This address has no published temporal decomposition. That is not a finding about the account — it means we have not measured it, and this endpoint will not guess."
}
Served from a snapshot
A live decomposition paginates fills and funding and runs 2,000 permutations per window — a nightly-cron cost, not a per-request one. The endpoint serves the published snapshot and shipsage_s so you know how stale it is.
Three Hyperliquid API facts shaped this module, and they will bite anything else reading fills:
- Funding is hourly, not on an 8-hour cadence. The 3-a-day assumption uses a denominator 8× too small.
- Spot fills are labelled
Buy/Sell, notClose Long/Close Short, and the reducing leg still carries a populatedclosedPnl. Filtering ondir.startswith('Close')silently drops them — on one live account that attributed 5,299ofa515,191 book. userFillsByTimeanduserFundingcap at 2,000 rows with no cursor. You get a correct measurement of the wrong period, with no error.
Scienter publishes impersonal market signals of general and regular circulation. Nothing here is investment, legal, or tax advice, or a recommendation to buy, sell, or hold any asset. Scienter is not a registered investment adviser or broker-dealer. Trading digital assets can result in the total loss of your funds — see Disclaimers for the full text.
Path Parameters
A 40-hex-character 0x address.
Pattern:
^0x[a-fA-F0-9]{40}$Query Parameters
Return one attribution mode instead of both.
Available options:
realization, exposure Trim the concentration tables to one partition.
Available options:
session, weekpart, hour_of_day