API Documentation

Free API to query what things are worth. No authentication required.

Base URL: https://oddworth.com/api/oddworth · Raw markdown for agents

GET/items

List all items with pagination, search, and category filtering.

Parameters

limitnumberdefault: 20Max 50

cursorstringFrom previous response's nextCursor

categorystringCategory ID filter

qstringSearch by name

Try it

https://oddworth.com/api/oddworth/items?limit=5&category=tech

GET/items/{slug}

Get a single item with full details. Add ?format=text for plain text.

Parameters

formatstring"text" for plain text output

Try it

https://oddworth.com/api/oddworth/items/bitcoin

GET/items/random

Get a random item.

Try it

https://oddworth.com/api/oddworth/items/random

GET/compare

Compare two items by slug. Returns both items and their value ratio.

Parameters

astringFirst item slug (required)

bstringSecond item slug (required)

Try it

https://oddworth.com/api/oddworth/compare?a=avocado-toast&b=bitcoin

GET/compare/random

Get a random comparison between two items.

Try it

https://oddworth.com/api/oddworth/compare/random

POST/ask

Ask a natural language question about item values. Rate limited to 10/min per IP.

Parameters

qstringYour question (max 500 chars, in JSON body)

Try it

curl -X POST https://oddworth.com/api/oddworth/ask -H "Content-Type: application/json" -d '{"q":"How many iPhones to buy a Ferrari?"}'

GET/docs

This documentation. Add ?format=md for raw markdown (great for agents and LLMs).

Parameters

formatstring"md" for markdown output

Try it

https://oddworth.com/api/oddworth/docs?format=md

Notes