Epoch
Health Warn
- License — License: MIT
- No description — Repository has no description
- Active repo — Last push 0 days ago
- Community trust — 24 GitHub stars
Code Warn
- network request — Outbound network request in src/exchanges/drift.ts
- process.env — Environment variable access in src/lib/config.ts
Permissions Pass
- Permissions — No dangerous permissions requested
This tool is an agent that monitors funding rate dislocations for Solana perpetual markets. It tracks specific markets, identifies extreme annualized rates, and alerts the user to potential carry setups, crowding risks, or sentiment shifts.
Security Assessment
Overall risk: Low. The agent does not request dangerous system permissions or execute arbitrary shell commands, and no hardcoded secrets were detected. It does make outbound network requests specifically within the `src/exchanges/drift.ts` file, which is expected for its core function of fetching live market data from an exchange API. It relies on environment variables located in `src/lib/config.ts` for configuration, which is a standard and generally secure practice as long as users do not expose their local `.env` files.
Quality Assessment
The project is licensed under the permissive and standard MIT license, making it freely available for use and modification. The codebase is actively maintained, with the most recent push occurring today. It has garnered 24 GitHub stars, indicating a small but present level of community trust and interest. However, the repository currently lacks an explicit description in its metadata, and the provided README excerpt appears to cut off, which slightly impacts documentation clarity.
Verdict
Safe to use.
Epoch
Funding-dislocation monitor for Solana perpetual markets.
Epoch tracks funding regime changes, catches extreme annualized rates, and explains whether the move looks like carry, crowding, or a squeeze setup.
Funding is one of the cleanest ways to see when positioning stops being balanced. When annualized rates stretch, the market is telling you that one side is paying too much to stay crowded.
Epoch turns that state into a readable monitor. It tracks the perp markets that matter, keeps enough history to tell whether the move is persistent or temporary, and only elevates the moments when funding becomes useful as a carry signal, a crowding warning, or a sentiment shift.
FETCH -> STORE HISTORY -> TEST EXTREMES -> CLASSIFY -> ALERT
Rate Board • Funding Alert • Why Funding Matters • At a Glance • Regime Guide • What Epoch Watches • How To Read A Funding Alert • Example Output • Alert Types • Risk Controls • Quick Start
Rate Board
Funding Alert
Why Funding Matters
Price tells you where the market moved. Funding tells you what traders are paying to stay on one side of that move.
That difference is why funding deserves its own monitor. When annualized rates get extreme, the setup often stops being a simple directional story and starts becoming a crowding story. That can create carry, fragility, reversal pressure, or all three at once.
Epoch is built for that layer. It does not try to be a full perp dashboard. It is much narrower than that. It is designed to tell you when funding stopped being background noise and became information worth acting on.
At a Glance
Use case: monitoring perp funding dislocations on Solana-related marketsPrimary input: hourly funding, annualized funding, direction, and recent funding historyPrimary failure mode: reacting to a headline rate without context on persistence or recent flipsBest for: operators looking for carry setups, crowding signals, or sentiment shifts in perp markets
The Funding Regime Guide
Epoch becomes more useful when the user stops thinking in one-off prints and starts thinking in states.
| State | What it means | Why it matters |
|---|---|---|
calm |
funding is near neutral | no edge yet, stay observant |
rich positive |
longs are paying meaningful premium | carry may be forming, crowding risk building |
rich negative |
shorts are paying meaningful premium | panic or forced shorting may be getting expensive |
flip |
funding crossed through zero with history support | positioning regime changed |
persistent extreme |
the same side stayed expensive across windows | the market is paying to stay crowded |
The point of the board is not merely to rank the biggest number. It is to decide which state the market entered and what that implies.
What Epoch Watches That Most Funding Boards Do Not
Most boards stop at "the rate is high." Epoch is built to answer the next questions:
- is the rate high enough to matter
- has it stayed high long enough to become useful
- did the market recently flip from one side paying to the other
- does the move look like clean carry, unstable crowding, or a sentiment transition
That extra layer is what makes the product feel like a monitor instead of a spreadsheet.
How It Works
Epoch follows a narrow loop:
- fetch current funding rates for the tracked perp markets
- append the latest samples to rolling market history
- compare the current rate against configured extreme thresholds
- detect sign flips only when the recent history actually crossed through zero
- frame the alert as carry, stress, or changing sentiment
The system should be selective. A board that screams at every update teaches the user to ignore the one update that mattered.
How To Read A Funding Alert
There are four questions that matter more than the absolute number:
- who is paying whom
- how expensive that payment became on an annualized basis
- whether the rate is stabilizing, accelerating, or reverting
- whether the recent history supports a real regime change
That is why Epoch keeps a history window. Without context, a high print can look more meaningful than it really is.
Where Epoch Actually Helps
Carry Setups
Sometimes the cleanest use of funding is simple: one side is paying too much, long enough, and the operator wants to know when the premium is worth attention.
Crowding Warnings
The market can remain expensive for longer than expected, but extreme persistence still matters. It tells you positioning is stretched.
Sentiment Transitions
Funding flips often reveal a change in posture before a narrative catches up. That is especially useful when a market stops trending smoothly and starts repricing participants.
Example Output
EPOCH // FUNDING ALERT
market SOL-PERP
annualized rate +92%
direction longs pay shorts
alert type extreme_positive
confidence 0.81
opportunity: funding is rich enough to watch for short-bias carry,
but crowding risk is elevated if the move persists.
Alert Types
| Type | What it means | Typical interpretation |
|---|---|---|
extreme_positive |
funding is unusually expensive on the long side | short-bias carry or crowded-long warning |
extreme_negative |
funding is unusually expensive on the short side | long-bias carry or panic unwind |
flip |
funding crossed through zero in recent history | positioning regime changed |
What A Good Epoch Signal Looks Like
- the annualized rate is materially stretched
- the history window supports persistence or a real flip
- the alert explains whether the edge is carry, crowding, or transition
- the confidence is high enough that the print deserves attention now
That sounds basic, but it is the difference between a useful market monitor and a noisy percentage feed.
Risk Controls
extreme threshold: prevents routine funding prints from becoming alertshistory-backed flips: zero-cross alerts only fire when recent samples actually support the regime changeconfidence floor: low-quality alerts are demoted before they reach the operatortracked market scope: the monitor stays focused on named markets instead of pretending to cover everything
Funding should be treated as a state variable, not a guaranteed trade. Epoch is strongest when it is used to frame opportunity and crowding, not as a blind execution trigger.
Quick Start
git clone https://github.com/EpochFunding/Epoch
cd Epoch
bun install
cp .env.example .env
bun run dev
Configuration
ANTHROPIC_API_KEY=sk-ant-...
SCAN_INTERVAL_MS=300000
EXTREME_RATE_THRESHOLD=0.01
ALERT_MIN_CONFIDENCE=0.65
HISTORY_WINDOW_HOURS=24
TRACKED_MARKETS=SOL-PERP,BTC-PERP,ETH-PERP,JTO-PERP,JUP-PERP
Support Docs
License
MIT
funding gets interesting when it stops looking normal.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found