{"name":"Human Judgment","summary":"Ask a real person. Pay per question (USDC over x402, or by card), get a named human's rating, pick, ranking or feedback back as JSON. No account.","protocol":"x402","x402Version":2,"network":"eip155:8453","payTo":"0xcb9b3F94387389e38EF2A7b3C0B851FB8325d7e9","paywallEnabled":true,"baseUrl":"https://judge.byronxlg.com","how_it_works":["POST the question as JSON to a judge's route. An unpaid request gets HTTP 402 with an x402 PAYMENT-REQUIRED header; pay with any x402 client and retry.","The paid call returns 202 with a request id and a poll_url straight away. A person then answers from their phone: usually minutes, sometimes hours.","GET the poll_url (free; add ?wait=25 to hold the connection up to 25 seconds) until status is answered or declined. Or send callback_url with the question and the finished request is POSTed to it.","Input is validated before payment, so a malformed question is never charged. Payment is final once the question is accepted: answers are best effort and there are no refunds."],"judges":[{"id":"byron","name":"Byron Smith","headline":"Data and AI architect. Builds and ships AI agents for a living.","bio":["I design and deliver agent systems for clients at a global consultancy: agents in production, the platforms they run on, and the evaluations that say whether they work.","Before that, three years in data and analytics advisory (data engineering, full-stack, then RAG and semantic search), a year as a software engineer, and five years as a combat engineer in the New Zealand Army.","I run a fleet of my own agent-built projects, so I spend most days deciding whether something an agent made is actually good."],"good_for":["Whether a page, pitch or product idea makes sense to someone seeing it cold","Developer tools, APIs, docs and agent-facing products","Copy, names and taglines for technical products","Plans and architecture for data and AI systems","Whether an AI-written thing reads as AI-written"],"not_for":["Legal, medical or financial advice","Anything needing a licensed professional","Facts a search would settle"],"location":"Auckland, New Zealand (UTC+12/13)","links":[{"label":"Projects","url":"https://byronxlg.com/"},{"label":"GitHub","url":"https://github.com/byronxlg"}],"available":false,"services":[{"kind":"rate","name":"Rate 1 to 10","price":"$0.50","url":"https://judge.byronxlg.com/byron/rate","summary":"Send one thing and what to rate it on. A person replies with a number from 1 to 10 and, often, a one-line reason."},{"kind":"pick","name":"Pick one","price":"$0.50","url":"https://judge.byronxlg.com/byron/pick","summary":"Send a question and two to five options. A person picks one and, often, says why. A yes/no question is the two-option case."},{"kind":"rank","name":"Rank these","price":"$1.00","url":"https://judge.byronxlg.com/byron/rank","summary":"Send a question and two to six options. A person puts them in order, best first, and says why the top one won."},{"kind":"feedback","name":"Open feedback","price":"$2.00","url":"https://judge.byronxlg.com/byron/feedback","summary":"Send a draft, design, plan or link and a question. A person replies in a few sentences: what works and what to change."}]}],"routes":[{"method":"POST","path":"/byron/rate","url":"https://judge.byronxlg.com/byron/rate","price":"$0.50","judge":"byron","kind":"rate","summary":"Send one thing and what to rate it on. A person replies with a number from 1 to 10 and, often, a one-line reason.","input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"subject":{"type":"string","minLength":1,"maxLength":4000,"description":"The thing to rate: text, or a short description of what is at the link."},"criterion":{"description":"What 10 means, e.g. \"clarity for a first-time reader\". Default: overall quality.","type":"string","maxLength":200},"context":{"description":"Who is asking and why, in a sentence or two. The judge reads it before answering.","type":"string","maxLength":600},"url":{"description":"A link the judge should open (a page, an image, a document).","type":"string","maxLength":500,"format":"uri"},"callback_url":{"description":"If set, the finished request is POSTed here as JSON when the judge answers. Polling still works.","type":"string","maxLength":500,"format":"uri"}},"required":["subject"],"additionalProperties":false},"answer":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"score":{"type":"integer","minimum":1,"maximum":10},"reason":{"description":"The judge's reason, when they gave one.","type":"string"}},"required":["score"],"additionalProperties":false},"response":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Request id. Keep it: knowing it is what lets you read the answer."},"status":{"type":"string","enum":["awaiting_payment","pending","answered","declined"]},"kind":{"type":"string"},"judge":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"price":{"type":"string"},"asked_at":{"type":["string","null"]},"answered_at":{"type":["string","null"]},"answer":{"description":"null until status is answered; then the answer in the shape the kind documents."},"decline_reason":{"type":"string"},"poll_url":{"type":"string","description":"Free. GET it (add ?wait=25 to hold the connection) until status is answered or declined."},"next":{"type":"string","description":"What to do next, in words."}},"required":["id","status","kind","judge","price","asked_at","answered_at","answer","poll_url","next"],"additionalProperties":false},"examples":{"input":{"subject":"Tagline for a budgeting app: 'Know where every dollar went before the month ends.'","criterion":"Would this make you click?"},"accepted":{"id":"req_3q2-7wEXAMPLEonly0000","status":"pending","kind":"rate","judge":{"id":"byron","name":"Byron Smith"},"price":"$0.50","asked_at":"2026-11-11T02:14:07.000Z","answered_at":null,"answer":null,"poll_url":"https://judge.byronxlg.com/requests/req_3q2-7wEXAMPLEonly0000","next":"A person is answering. GET https://judge.byronxlg.com/requests/req_3q2-7wEXAMPLEonly0000?wait=25 until status is \"answered\" or \"declined\"."},"answered":{"id":"req_3q2-7wEXAMPLEonly0000","status":"answered","kind":"rate","judge":{"id":"byron","name":"Byron Smith"},"price":"$0.50","asked_at":"2026-11-11T02:14:07.000Z","answered_at":"2026-11-11T02:21:40.000Z","answer":{"score":6,"reason":"Clear, but it sounds like every other budgeting app."},"poll_url":"https://judge.byronxlg.com/requests/req_3q2-7wEXAMPLEonly0000","next":"Done."}}},{"method":"POST","path":"/byron/pick","url":"https://judge.byronxlg.com/byron/pick","price":"$0.50","judge":"byron","kind":"pick","summary":"Send a question and two to five options. A person picks one and, often, says why. A yes/no question is the two-option case.","input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"question":{"type":"string","minLength":1,"maxLength":600,"description":"What is being chosen, and by what test."},"options":{"minItems":2,"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":600},"description":"Two to five options. They are shown to the judge as A, B, C..."},"context":{"description":"Who is asking and why, in a sentence or two. The judge reads it before answering.","type":"string","maxLength":600},"url":{"description":"A link the judge should open (a page, an image, a document).","type":"string","maxLength":500,"format":"uri"},"callback_url":{"description":"If set, the finished request is POSTed here as JSON when the judge answers. Polling still works.","type":"string","maxLength":500,"format":"uri"}},"required":["question","options"],"additionalProperties":false},"answer":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"choice":{"type":"string","description":"Letter of the chosen option: A is options[0]."},"index":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Zero-based index into the options you sent."},"option":{"type":"string","description":"The chosen option's text, echoed back."},"reason":{"description":"The judge's reason, when they gave one.","type":"string"}},"required":["choice","index","option"],"additionalProperties":false},"response":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Request id. Keep it: knowing it is what lets you read the answer."},"status":{"type":"string","enum":["awaiting_payment","pending","answered","declined"]},"kind":{"type":"string"},"judge":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"price":{"type":"string"},"asked_at":{"type":["string","null"]},"answered_at":{"type":["string","null"]},"answer":{"description":"null until status is answered; then the answer in the shape the kind documents."},"decline_reason":{"type":"string"},"poll_url":{"type":"string","description":"Free. GET it (add ?wait=25 to hold the connection) until status is answered or declined."},"next":{"type":"string","description":"What to do next, in words."}},"required":["id","status","kind","judge","price","asked_at","answered_at","answer","poll_url","next"],"additionalProperties":false},"examples":{"input":{"question":"Which name is better for a tool that renames photos by date?","options":["Datestamp","Chrono","PhotoSort"]},"accepted":{"id":"req_3q2-7wEXAMPLEonly0000","status":"pending","kind":"pick","judge":{"id":"byron","name":"Byron Smith"},"price":"$0.50","asked_at":"2026-11-11T02:14:07.000Z","answered_at":null,"answer":null,"poll_url":"https://judge.byronxlg.com/requests/req_3q2-7wEXAMPLEonly0000","next":"A person is answering. GET https://judge.byronxlg.com/requests/req_3q2-7wEXAMPLEonly0000?wait=25 until status is \"answered\" or \"declined\"."},"answered":{"id":"req_3q2-7wEXAMPLEonly0000","status":"answered","kind":"pick","judge":{"id":"byron","name":"Byron Smith"},"price":"$0.50","asked_at":"2026-11-11T02:14:07.000Z","answered_at":"2026-11-11T02:21:40.000Z","answer":{"choice":"A","index":0,"option":"Datestamp","reason":"Says what it does."},"poll_url":"https://judge.byronxlg.com/requests/req_3q2-7wEXAMPLEonly0000","next":"Done."}}},{"method":"POST","path":"/byron/rank","url":"https://judge.byronxlg.com/byron/rank","price":"$1.00","judge":"byron","kind":"rank","summary":"Send a question and two to six options. A person puts them in order, best first, and says why the top one won.","input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"question":{"type":"string","minLength":1,"maxLength":600,"description":"What the options are being ranked on."},"options":{"minItems":2,"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":600},"description":"Two to six options. They are shown to the judge as A, B, C..."},"context":{"description":"Who is asking and why, in a sentence or two. The judge reads it before answering.","type":"string","maxLength":600},"url":{"description":"A link the judge should open (a page, an image, a document).","type":"string","maxLength":500,"format":"uri"},"callback_url":{"description":"If set, the finished request is POSTed here as JSON when the judge answers. Polling still works.","type":"string","maxLength":500,"format":"uri"}},"required":["question","options"],"additionalProperties":false},"answer":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"order":{"type":"array","items":{"type":"string"},"description":"Letters, best first: A is options[0]."},"ranked":{"type":"array","items":{"type":"string"},"description":"The options' text in the judge's order, best first."},"reason":{"description":"The judge's reason, when they gave one.","type":"string"}},"required":["order","ranked"],"additionalProperties":false},"response":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Request id. Keep it: knowing it is what lets you read the answer."},"status":{"type":"string","enum":["awaiting_payment","pending","answered","declined"]},"kind":{"type":"string"},"judge":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"price":{"type":"string"},"asked_at":{"type":["string","null"]},"answered_at":{"type":["string","null"]},"answer":{"description":"null until status is answered; then the answer in the shape the kind documents."},"decline_reason":{"type":"string"},"poll_url":{"type":"string","description":"Free. GET it (add ?wait=25 to hold the connection) until status is answered or declined."},"next":{"type":"string","description":"What to do next, in words."}},"required":["id","status","kind","judge","price","asked_at","answered_at","answer","poll_url","next"],"additionalProperties":false},"examples":{"input":{"question":"Rank these subject lines by how likely you are to open the email.","options":["Your March report is ready","3 things that changed this month","Quick question"]},"accepted":{"id":"req_3q2-7wEXAMPLEonly0000","status":"pending","kind":"rank","judge":{"id":"byron","name":"Byron Smith"},"price":"$1.00","asked_at":"2026-11-11T02:14:07.000Z","answered_at":null,"answer":null,"poll_url":"https://judge.byronxlg.com/requests/req_3q2-7wEXAMPLEonly0000","next":"A person is answering. GET https://judge.byronxlg.com/requests/req_3q2-7wEXAMPLEonly0000?wait=25 until status is \"answered\" or \"declined\"."},"answered":{"id":"req_3q2-7wEXAMPLEonly0000","status":"answered","kind":"rank","judge":{"id":"byron","name":"Byron Smith"},"price":"$1.00","asked_at":"2026-11-11T02:14:07.000Z","answered_at":"2026-11-11T02:21:40.000Z","answer":{"order":["B","A","C"],"ranked":["3 things that changed this month","Your March report is ready","Quick question"],"reason":"B promises something specific; C reads as spam."},"poll_url":"https://judge.byronxlg.com/requests/req_3q2-7wEXAMPLEonly0000","next":"Done."}}},{"method":"POST","path":"/byron/feedback","url":"https://judge.byronxlg.com/byron/feedback","price":"$2.00","judge":"byron","kind":"feedback","summary":"Send a draft, design, plan or link and a question. A person replies in a few sentences: what works and what to change.","input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"subject":{"type":"string","minLength":1,"maxLength":6000,"description":"The draft, plan, copy or description to give feedback on."},"question":{"description":"What you want to know, e.g. \"What would stop you signing up?\". Default: what works and what to change.","type":"string","maxLength":600},"context":{"description":"Who is asking and why, in a sentence or two. The judge reads it before answering.","type":"string","maxLength":600},"url":{"description":"A link the judge should open (a page, an image, a document).","type":"string","maxLength":500,"format":"uri"},"callback_url":{"description":"If set, the finished request is POSTed here as JSON when the judge answers. Polling still works.","type":"string","maxLength":500,"format":"uri"}},"required":["subject"],"additionalProperties":false},"answer":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"feedback":{"type":"string","description":"The judge's feedback, in their own words."}},"required":["feedback"],"additionalProperties":false},"response":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Request id. Keep it: knowing it is what lets you read the answer."},"status":{"type":"string","enum":["awaiting_payment","pending","answered","declined"]},"kind":{"type":"string"},"judge":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"price":{"type":"string"},"asked_at":{"type":["string","null"]},"answered_at":{"type":["string","null"]},"answer":{"description":"null until status is answered; then the answer in the shape the kind documents."},"decline_reason":{"type":"string"},"poll_url":{"type":"string","description":"Free. GET it (add ?wait=25 to hold the connection) until status is answered or declined."},"next":{"type":"string","description":"What to do next, in words."}},"required":["id","status","kind","judge","price","asked_at","answered_at","answer","poll_url","next"],"additionalProperties":false},"examples":{"input":{"subject":"Landing page hero: 'Ship faster with AI.' Sub-line: 'The all-in-one platform for modern teams.' Button: 'Get started'.","question":"What would stop you signing up?"},"accepted":{"id":"req_3q2-7wEXAMPLEonly0000","status":"pending","kind":"feedback","judge":{"id":"byron","name":"Byron Smith"},"price":"$2.00","asked_at":"2026-11-11T02:14:07.000Z","answered_at":null,"answer":null,"poll_url":"https://judge.byronxlg.com/requests/req_3q2-7wEXAMPLEonly0000","next":"A person is answering. GET https://judge.byronxlg.com/requests/req_3q2-7wEXAMPLEonly0000?wait=25 until status is \"answered\" or \"declined\"."},"answered":{"id":"req_3q2-7wEXAMPLEonly0000","status":"answered","kind":"feedback","judge":{"id":"byron","name":"Byron Smith"},"price":"$2.00","asked_at":"2026-11-11T02:14:07.000Z","answered_at":"2026-11-11T02:21:40.000Z","answer":{"feedback":"I can't tell what it does. 'Ship faster' and 'all-in-one platform' fit any product. Say the one thing it does for me in the headline, then show it."},"poll_url":"https://judge.byronxlg.com/requests/req_3q2-7wEXAMPLEonly0000","next":"Done."}}}],"free":[{"method":"GET","path":"/requests/{id}","summary":"Status and answer of a request. ?wait=<seconds, max 25> holds the connection until it is answered."},{"method":"GET","path":"/judges","summary":"Who is answering, what they are good at, and what they charge."}]}