# Horse Truth Machine Intelligence

> Paid machine-readable derived Australian racehorse intelligence for AI agents, MCP clients, software and publishers.
> Raw provider records are not exposed. Race Day selections are sealed separately. Paying for access never changes a ranking.
> Horse Truth gives no betting advice and uses no odds.

## Start here (no human needed)
1. Free sample for any horse, no key: https://horsetruth.com.au/api/v1/sandbox/horse?name={horse_name}
   Fixed free sample: https://horsetruth.com.au/api/v1/sandbox/chance-with-wolves
   Free race catalogue: https://horsetruth.com.au/api/v1/race-field-read/catalogue
   Free MCP tools: sandbox_preview, discover_purchase_options at https://horsetruth.com.au/api/v1/mcp
2. Cheapest paid call: resolve_horse at US$0.001: https://horsetruth.com.au/api/v1/x402/resolve-horse?q={horse_name}
3. Pay with x402: the first reply is HTTP 402 with a PAYMENT-REQUIRED header. Sign it, send PAYMENT-SIGNATURE, retry the same request.
4. Other paid x402 calls (price per successful result):
   - resolve_horse: US$0.001: https://horsetruth.com.au/api/v1/x402/resolve-horse?q={horse_name}
   - horse_changes: US$0.02: https://horsetruth.com.au/api/v1/x402/horse-changes?horse={horse_name}
   - horse_compare: US$0.02: https://horsetruth.com.au/api/v1/x402/horse-compare?horses={horses}
   - horse_explanation: US$0.02: https://horsetruth.com.au/api/v1/x402/horse-explanation?horse={horse_name}
   - horse_intelligence: US$0.02: https://horsetruth.com.au/api/v1/x402/horse-intelligence?horse={horse_name}
   - horse_provenance: US$0.02: https://horsetruth.com.au/api/v1/x402/horse-provenance?horse={horse_name}
   - horse_rankings: US$0.02: https://horsetruth.com.au/api/v1/x402/rankings?limit={limit}
   - horse_signal: US$0.02: https://horsetruth.com.au/api/v1/x402/horse-signal?horse={horse_name}&signal={signal}
   - horse_snapshot: US$0.02: https://horsetruth.com.au/api/v1/x402/horse-snapshot?horse={horse_name}
   - race_field_read: US$1.00: https://horsetruth.com.au/api/v1/x402/race-field-read?date={date}&track={track}&race={race}

## What Horse Truth is
- Horse Truth Racing Intelligence (https://horsetruth.com.au): reads on Australian racehorses and races, for people and for AI agents.
- Horse and race intelligence, read from form, timing and sectional records. No odds are used.
- Selections are sealed with a timestamp before the race starts.
- Every miss is published next to every hit on the public record.
- Each read says in plain words why a horse ranks where it does, and where the evidence is thin.
- Proof: https://horsetruth.com.au/record (machine copy: https://horsetruth.com.au/record.json)
- Not betting advice. For people aged 18 and over.

## For people
- Horse Truth Full Access: A$19 a month. Follow more horses, get an alert when Horse Truth's view of a followed horse changes, and read the full reason. https://horsetruth.com.au/plan
- Horse Check: A$29 once. One dated intelligence report on one horse, for buyers and owners. No account needed. https://horsetruth.com.au/horse-check
- Free: horse pages https://horsetruth.com.au/horses, the Truth Board https://horsetruth.com.au/truth, rankings https://horsetruth.com.au/rankings, free run reports for trainers https://horsetruth.com.au/partners

## Start
- Developer storefront: https://horsetruth.com.au/developers
- Free sandbox: https://horsetruth.com.au/api/v1/sandbox/chance-with-wolves
- Free sample for any horse: https://horsetruth.com.au/api/v1/sandbox/horse?name={horse_name}
- Machine products: https://horsetruth.com.au/api/v1/machine/products
- Machine discovery: https://horsetruth.com.au/api/v1/machine/discovery
- Tollbooth catalog: https://horsetruth.com.au/api/v1/machine/tollbooths
- OpenAPI 3.1: https://horsetruth.com.au/api/v1/machine/openapi.json
- Postman collection: https://horsetruth.com.au/api/v1/machine/postman_collection.json
- MCP Registry server.json: https://horsetruth.com.au/api/v1/machine/mcp-server.json
- RapidAPI import OpenAPI 3.0.2: https://horsetruth.com.au/api/v1/machine/rapidapi-openapi.json

## MCP
- Endpoint: https://horsetruth.com.au/api/v1/mcp
- Preferred protocol: 2026-07-28 stateless HTTP
- Free tools require no key: sandbox_preview, discover_purchase_options
- Paid tools support native x402 MCP payment: retry the same tools/call with _meta['x402/payment'] after a PaymentRequired result
- Reusable direct-key fallback: Authorization: Bearer <Horse Truth machine key>
- Paid tools: horse_intelligence, horse_changes, horse_rankings, resolve_horse, horse_snapshot, horse_explanation, horse_compare, horse_provenance, horse_signal

## Commercial boundary
- Preferred autonomous entry: x402 accountless payment under /api/v1/x402/: US$0.001 for resolve-horse, US$0.02 per successful result for horse intelligence calls, US$1.00 for a whole race-field-read.
- Read PAYMENT-REQUIRED, submit PAYMENT-SIGNATURE, and retry the same request; no Horse Truth machine key or browser checkout is required.
- Marketplace fallback: Apify Pay-Per-Event = US$0.02 per successful result: https://apify.com/crocheted_poacher/horse-truth-machine-intelligence
- Direct reusable-key entry: AI_AGENT_TRIAL = A$1 one-time for 50 machine credits
- One successful direct paid call consumes 1 credit; effective trial price is A$0.02/call
- Direct checkout: POST https://horsetruth.com.au/api/v1/machine/checkout with JSON {"product_key":"AI_AGENT_TRIAL"}
- Direct secondary pack: AI_AGENT_MICRO = A$5 one-time for 250 credits
- Claim direct machine key after confirmed payment: POST https://horsetruth.com.au/api/v1/machine/claim
- Subscription + included metered credits
- Automatic overage billing is not enabled
- Machine billing controls access only and cannot alter scientific authority


## Direct reusable-key pricing
- Preferred autonomous entry remains x402 accountless payment: US$0.001 to resolve a horse, US$0.02 per successful intelligence result, US$1.00 for a whole race.
- Marketplace fallback: Apify Pay-Per-Event = US$0.02 per successful result.
- Apify Actor: https://apify.com/crocheted_poacher/horse-truth-machine-intelligence
- Direct entry: A$1 one-time buys 50 Horse Truth machine credits.
- One successful direct paid call consumes 1 credit: A$0.02 effective per call.
- Direct checkout: POST https://horsetruth.com.au/api/v1/machine/checkout with product_key=AI_AGENT_TRIAL.
- Direct secondary option: A$5 one-time buys 250 Horse Truth machine credits.
- Claim the direct machine key after payment at https://horsetruth.com.au/api/v1/machine/claim.