Machine quickstart

1. Discover

Read any of these. They all agree on tools, prices and links.

• Machine discovery (JSON)
• llms.txt and llms-full.txt
• OpenAPI
• MCP server card and A2A agent card

2. Free sample

Try any horse first. No key, no payment.

GET https://horsetruth.com.au/api/v1/sandbox/horse?name=Chance%20With%20Wolves

Fixed sample: /api/v1/sandbox/chance-with-wolves. Free race list: /api/v1/race-field-read/catalogue. Free MCP tools: sandbox_preview and discover_purchase_options at https://horse-truth-edge-production.up.railway.app/api/v1/mcp.

3. Cheapest paid call

resolve_horse for US$0.001.

GET https://horsetruth.com.au/api/v1/x402/resolve-horse?q={horse_name}

With x402 the first reply is HTTP 402 with a PAYMENT-REQUIRED header (base64 JSON). Sign it, send PAYMENT-SIGNATURE, and retry the same request. The paid reply carries PAYMENT-RESPONSE. No account and no browser.

4. Paid calls

• 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}

Prefer a reusable key? POST /api/v1/machine/checkout with {"product_key":"AI_AGENT_TRIAL"}: A$1 for 50 calls. Claim the key with POST /api/v1/machine/claim. Full product list at /api/v1/machine/products.