6 methods · solana-agent-kit + MCP skill

Agent API

sports-workbench exposes 6 methods on the SolanaAgentKit interface. Each method returns a Verifiable Settlement Receipt alongside its payload — agents can read the result, present it to a user, and ship the proof.

install plugin

// TypeScriptimport { TxlinePlugin } from "@srivtx/sports-workbench";
import { SolanaAgentKit } from "solana-agent-kit";

const agent = new SolanaAgentKit({ wallet, network: "devnet" });
agent.use(new TxlinePlugin({ apiToken: process.env.TXLINE_API_TOKEN }));

const sig = await agent.methods.findSharpMove({
  fixtureId: 17588234,
  strategy: "sharpDetector",
  threshold: 0.5,
});
// → { signal: Signal, receipt: Receipt }

Methods

backtestOddsREAD

Replay historical TxLINE odds against any of the 4 strategies. Returns a list of signals plus aggregate PnL, hit rate, and a Verifiable Settlement Receipt per signal.

params

strategy enum — sharpDetector | momentum | meanReversion | custom

fixtureId u64 — Single fixture or omit for all

from u64 — Unix ms start

to u64 — Unix ms end

threshold f64 — Signal threshold (default 0.5)

returns

{ signals: Signal[], pnl: f64, hitRate: f64, receipts: Receipt[] }

findSharpMoveREAD

Scan the live TxLINE SSE feed for a single fixture and emit signals the moment a threshold move is detected. Persists receipts to .sports-workbench-state.json.

params

fixtureId u64 — Required

strategy enum — Default: sharpDetector

threshold f64 — Default 0.5

returns

Stream<Signal>

getOddsREAD

Fetch the current canonical odds for a fixture across all market types. Each call includes a Merkle proof so callers can verify the data on Solana.

params

fixtureId u64 — Required

marketTypes string[] — Optional filter

returns

{ fixtureId, markets: Market[], receipt: Receipt }

getFixturesREAD

List fixtures for a competition (or all 8 leagues + World Cup). Free tier covers 8 soccer leagues; 7-day replay available for paid.

params

competition string — Optional - default all

status enum — live | upcoming | finished

returns

Fixture[]

proveOddsPROOF

Resolve a (fixture, messageId) pair against the on-chain Merkle root. Returns a signed attestation suitable for downstream use (settlement, audit, dispute).

params

fixtureId u64 — Required

messageId string — TxLINE MessageId

returns

Receipt (programId, batchRootsPda, subTreeProof, mainTreeProof)

describeStrategyREAD

Return the natural-language + mathematical definition of a strategy. Useful for agent planning, prompt engineering, and audit trails.

params

strategy enum — sharpDetector | momentum | meanReversion | custom

returns

{ name, summary, math, params: Param[] }