machineODDS // Agent Skill

Install structured sports prediction-market signal intelligence into your agent runtime.
Works with hosted agents, autonomous runtimes, LLM frameworks, and custom operator pipelines.

What this Skill is for

Use this Skill with any agent framework or runtime that can ingest a system prompt, instruction URL, or Skill document — Hermes, OpenClaw, custom autonomous runtimes, hosted agents, or your own operator pipeline. Not limited to any one platform.

machineODDS delivers structured executable-fresh signal JSON. No custody. No direct venue execution. Your agent consumes the signals and executes externally through its own venue connector and wallet.

Install
Skill URL:      https://machineodds.live/agent-skill.md
Format:       plain markdown — fetch or paste into agent system prompt
Frameworks:   Hermes, OpenClaw, custom operator runtimes, hosted agents, any LLM agent
Paid access — two live rails

Free endpoints return sanitized discovery rows only.
Paid full JSON unlocks edge, price, depth, notional, and execution fields.

Rail A — USDC x402

0.50 USDC per call · stateless · no account needed

Attach X-Payment header · settles on Base
/.well-known/x402 — payment manifest

Rail B — $mODDS Credits

337,824 $mODDS = 1 credit · spend per call

quote → transfer → verify → balance → sign → spend
/credits/modds/quote — pricing & flow

$mODDS credit flow (proven)
1. quote    GET /credits/modds/quote?wallet=0x...
2. transfer  send quoted $mODDS on Base → receiving_wallet
3. verify    POST /credits/verify-modds { tx_hash, wallet_address }
4. balance   GET /credits/balance?wallet=0x... → can_spend=true
5. message   GET /signal/credit/message?wallet_address=...&nonce=...&expires_at=...
6. sign      EIP-191 personal_sign — never share key
7. spend     POST /signal/credit { wallet_address, nonce, expires_at, signature }
8. confirm   payment_verified=true + signal_id + agent_trade_ticket in response

Note: $mODDS x402/Permit2 is not the live path. Use the signed credit-spend flow above. MODDS_WALLET_ADDRESS is your funding wallet — not the machineODDS receiver.

REST endpoints
GET /signals/latestfree ranked signals — discovery only free
GET /signal/previewfree cache-first preview — discovery only free
POST /signal/strongestx402 · 0.50 USDC · full paid signal JSON x402
POST /signal/credit$mODDS credit spend · full paid signal JSON $mODDS
POST /signals/batchpaid batch · venue/edge/sort filters x402 $mODDS
GET /signal/credit/messagecanonical EIP-191 signable message free
GET /credits/balancecredit_balance + can_spend free
GET /credits/modds/quote$mODDS pricing and purchase flow free
GET /.well-known/x402x402 payment manifest free
GET /capabilitiesvenue/lane/feature flags free
GET /schemasignal field schema free
GET /docsOpenAPI / Swagger UI free

// free ranked signals · x402 USDC · $mODDS credits
// no custody · no order placement · structured signal JSON only
// external execution by operator agent through own venue connector