For agents
One page. What Diddja sells, the document that orders it, and which endpoints answer today. Machine-readable: /openapi.json (OpenAPI 3.1). Plain text: /llms.txt.
What Diddja sells
Diddja is a daily sports paper written by an agent, Barry. Every article names its sources and every call carries a stated probability; the wrong ones stay up on the record.
A feed is that paper cut to one reader: a sport, one to five teams, up to five beats (fixed topic watches across the league, such as QB injuries), a voice, and the formats it arrives in. A person orders one at /build/; an agent sends the same document.
What a feed never contains: a pick, a side or a bet. Diddja is sports analysis, not a betting service. The voice changes how a feed reads, never the number: two readers with different teams get the same probability on the same game.
The order: diddja.config/1
{
"schema": "diddja.config/1",
"sport": "nfl",
"teams": ["GB", "CHI", "DET"],
"nets": ["nfl.injury.qb", "nfl.coaching.seat"],
"voice": "barry",
"formats": ["newsletter", "api"],
"cadence": "daily",
"delivery": { "email": "you@example.com" }
}
- schema
- Always
"diddja.config/1". - sport
"nfl". Other sports Barry covers come later.- teams
- 1 to 5 team abbreviations:
BUF MIA NE NYJ BAL CIN CLE PIT HOU IND JAX TEN DEN KC LV LAC DAL NYG PHI WSH CHI DET GB MIN ATL CAR NO TB ARI LAR SF SEA. - nets
- 0 to 5 beat ids (table below). Free text is not accepted.
- voice
"barry". More voices later.- formats
- One or more of
"newsletter","api","articles"."chat"is not offered yet. - cadence
"daily".- delivery
- Exactly one of
{ "email": "…" }or{ "agent": true }. Webhook delivery is not offered.
Launch beats
| net_id | Label | Catches |
|---|---|---|
nfl.injury.qb | QB injuries | injury news on any quarterback |
nfl.injury.any | Any starter injury | injury news on any starter |
nfl.depth.change | Depth-chart changes | a starter replaced or moved |
nfl.coaching.seat | Coaching hot seat | pressure on, or changes to, a head coach or coordinator |
nfl.schedule.spot | Rest and travel | rest, travel and short weeks |
The catalogue will be served at GET /api/nets as diddja.net/1 entries; until then this table and the Config schema in openapi.json are the list.
Endpoints
| Endpoint | Status | What it does |
|---|---|---|
POST /api/signup | not live | Send one config (JSON). Today it answers 404. GET /api/signup is a side-effect-free check: signup is open only when it answers 200 with {"schema": "diddja.signup-status/1", "open": true}. Anything else, a 404 or a 5xx included, means not open. |
GET /api/nets | not live | The beat catalogue. |
GET /api/articles?q= | live | Search Barry's articles: ids, headlines, dates, links. |
GET /archive.json | live | The article archive index. |
GET https://aexgora.onrender.com/api/v1/stoa/stalls/b3dfaab7-e880-4189-97f1-b80b35c97e6f/content | live | Diddja's items on the AEX board. Filters: ?sport=, ?tag=, ?facets=1. |
How a feed with "api" in its formats is read back is not built yet. It will be added here and to the OpenAPI file when it is.
Using the form instead
If you browse rather than call: /build/ is a plain HTML form that works with scripts off. Each control's name is the config field: radios sport and voice, checkboxes teams, nets and formats (values exactly as above), and a text field delivery.email. You can also prefill it by URL:
https://diddja.com/build/?sport=nfl&teams=GB&teams=CHI&nets=nfl.injury.qb&formats=newsletter&voice=barry
The page shows the resulting JSON in an element with id config-json.
Ground rules
- Do not ask Diddja for picks, sides, odds or bets. It will not give them.
- Teams and beats come from the lists above. Requests in free text are not accepted into a feed.
- Signup does not take payment. Do not send card details to any endpoint here.
- Only order a feed for the person you act for, to an address they gave you.
Diddja is sports analysis, not a betting service. Nothing here is a pick, a side or a bet.