gitwtfhub

wtf is halcyon?

0xkinno/halcyon — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 4/5Setup · hard

TL;DR

An automated agent that trades on live sports odds and settles bets on Solana using cryptographic proofs instead of a trusted middleman.

Mindmap

mindmap
  root((halcyon))
    What it does
      Automated sports trading agent
      Detects odds anomalies
      Trustless settlement
    Tech stack
      TypeScript and Next.js
      Solana Devnet
      TxLINE data feed
    Use cases
      Live odds trading demo
      Merkle proof verification
      Strategy experimentation
    Audience
      Developers
      Blockchain builders
    Strategies
      Momentum agent
      Reversion agent
      Multi condition triggers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Watch a live demo of an automated sports trading agent settling bets on-chain.

REASON 2

Study how statistical anomaly detection can trigger automated on-chain trades.

REASON 3

Learn how Merkle proofs are used to verify sports results before releasing funds.

REASON 4

See an example of combining multiple match statistics into one prediction condition.

What's in the stack?

TypeScriptNext.jsSolana

How it stacks up

0xkinno/halcyon0xkinno/astraea0xpulseplay/divergence-desk
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhardhard
Complexity4/54/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires a Solana Devnet setup and depends on the separately hosted TxLINE live data feed for real odds.

Wtf does this do

Halcyon is an automated trading agent that bets on live sports odds and settles those bets on the Solana blockchain, without needing anyone to trust a middleman. It watches live match data from a service called TxLINE, spots unusual shifts in the odds using statistics, and then places matching trades on-chain based on those shifts. The project is built to solve a specific problem: most sports betting engines rely on a central authority to say who won and to pay out correctly, and there is no way to independently confirm that the odds and scores used for settlement were not altered. Halcyon instead connects directly to TxLINE's live data stream, checks for statistically significant changes in things like possession or goal totals, opens matched trade positions on Solana, and pays out winners only after a cryptographic proof, called a Merkle proof, confirms the final result on-chain. The system evaluates combinations of conditions at once, such as a goal difference of one or fewer together with a certain number of corners, rather than looking at a single stat in isolation. Each of these condition sets becomes a single tracked prediction. Two example trading agents are described: one called Momentum, and one called Reversion, which take opposite positions and settle automatically once a match concludes. The README walks through a demo flow: starting the system from a dashboard, watching live signal detection as odds move, monitoring open positions as the two agents trade, and inspecting the final settlement receipt with its cryptographic proof. It also includes a table clarifying which parts of the demo use real on-chain Solana transactions versus a fallback simulator that fills in data if the live TxLINE stream is idle. The project runs on Solana's test network, Devnet, and is built with Next.js.

Yoink these prompts

Prompt 1
Explain how Halcyon detects statistically significant odds movements before trading.
Prompt 2
Walk me through Halcyon's settlement flow from signal detection to Merkle proof verification.
Prompt 3
Help me understand the difference between the Momentum and Reversion trading strategies in Halcyon.
Prompt 4
Show me which parts of Halcyon's demo use real Solana transactions versus simulated data.

Frequently asked questions

wtf is halcyon?

An automated agent that trades on live sports odds and settles bets on Solana using cryptographic proofs instead of a trusted middleman.

What language is halcyon written in?

Mainly TypeScript. The stack also includes TypeScript, Next.js, Solana.

How hard is halcyon to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is halcyon for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.