llms.txt Content
# WZRD — AI Model Velocity Oracle
> Adoption velocity for 100+ AI models. Free API. Gasless rewards on Solana.
## Signal Feed (free, no auth)
GET https://api.twzrd.xyz/v1/signals/momentum
Returns: model, trend, score, action, confidence, platform, capabilities.
Filters: ?limit=N, ?platform=huggingface, ?trending=true, ?capability=code
## Prediction Market Signals (free, no auth)
GET https://api.twzrd.xyz/v1/dflow/score/{ticker}
Returns: ticker, market_probability, fair_probability, edge, confidence, horizon_days, drivers, scored_at.
Coverage today: supported DFlow/Kalshi macro markets (currently CPI and NFP families). Use this before quoting or trading a prediction market.
## Read (free, zero config)
```python
pip install wzrd-client
import wzrd
model = wzrd.pick("code") # best model for task (output varies with live signal)
top = wzrd.shortlist("reasoning", n=3) # ranked list
```
No API key. No account. Works immediately.
## Earn CCM (requires Solana keypair)
Agents that report verified inference earn CCM tokens. Earning runs in your agent's runtime:
```python
wzrd.run_loop(stake=True)
# authenticates → picks models → runs inference → reports → claims CCM
```
On first run, `wzrd-client` auto-generates a dedicated keypair at `~/.config/solana/wzrd-agent.json`. Pass `keypair="path/to/id.json"` only if you already have one. Claims are gasless — no SOL required.
## Listen API (passive music witness)
Base URL for the Python helper/client:
GET https://api.twzrd.xyz/health
POST https://api.twzrd.xyz/v1/listen/session/start
POST https://api.twzrd.xyz/v1/listen/session/checkpoint
POST https://api.twzrd.xyz/v1/listen/session/finalize
POST https://api.twzrd.xyz/v1/listen/summary
Used by `wzrd-listen`, a passive local witness client for music sessions. Sources are generic from day one: `spotify`, `apple_music`, `youtube_music`, `local_audio`.
## Agent Auth (Ed25519 challenge/verify)
POST https://api.twzrd.xyz/v1/agent/challenge
OpenAPI Spec (preview)
{
"openapi": "3.0.3",
"info": {
"title": "WZRD Velocity Oracle API",
"version": "2.0.0",
"description": "AI model velocity oracle. Measures real-time developer adoption across HuggingFace, GitHub, OpenRouter, and ArtificialAnalysis. Free to read. Agents earn CCM via server-witnessed inference. 9 Switchboard feeds on Solana mainnet. Verify on-chain: solana account AepiFwnbfCvXwA5gtAysMaxoqdwsGiYCN6gFBLGqZf1S"
},
"externalDocs": {
"description": "On-chain Switchboard feeds