{"openapi":"3.1.0","info":{"title":"Compounder Market API","version":"0.1.0","description":"Deterministic decision tools for autonomous operators, settled in USDC on Base through x402 v2.","contact":{"name":"Compounder Market API","url":"https://github.com/SupremeDreamZ/compounder-market-api"},"x-guidance":"Use GET /api/bounty-score/example to inspect a fixed free result. Use POST /api/bounty-score with a JSON opportunity body for a paid assessment. On HTTP 402, satisfy the x402 v2 exact-payment challenge and retry the same request."},"servers":[{"url":"https://compounder-market-api.vercel.app","description":"Production"}],"externalDocs":{"description":"Source, tests, and operations documentation","url":"https://github.com/SupremeDreamZ/compounder-market-api"},"tags":[{"name":"Scoring","description":"Opportunity scoring and evidence-gated decisions"},{"name":"Discovery","description":"Free schemas, examples, and service health"}],"x-discovery":{"ownershipProofs":["0x56f7faf1bf7c3bb03a1463ef9bf381412fee8646b78f01eaa7f91ddde8c997eb389896e62ea62117bdc787648b40caf803df09552183e66b152f95e6424118231b"]},"paths":{"/api/health":{"get":{"operationId":"getHealth","summary":"Inspect service and payment configuration","tags":["Discovery"],"security":[],"responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}}}}},"/api/bounty-score":{"get":{"operationId":"getBountyScoreDocumentation","summary":"Inspect Bounty Fit Scorer documentation","tags":["Discovery"],"security":[],"responses":{"200":{"description":"Scorer documentation, schema links, and fixed example","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"operationId":"scoreBounty","summary":"Score a bounty or paid opportunity","description":"Returns a deterministic 0-100 score, pursue/skip verdict, expected value, breakdown, hard stops, risks, strengths, and recommended action.","tags":["Scoring"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xc7A7563793C3aeaCA9177a4aa2e4fd7C01F7Eb35","facilitator":"https://facilitator.payai.network"}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BountyInput"},"example":{"title":"Write a five-post launch thread","payoutUsd":250,"hoursEstimate":4,"daysToDeadline":5,"daysToPayout":14,"existingSubmissions":12,"fit":5,"paymentCertainty":4,"aiLeverage":5,"reuseValue":4,"cashCostUsd":0,"requiresAccount":true,"requiresPublicPost":false,"requiresPurchase":false,"agentAccessible":true,"humanSupportAvailable":false,"verifiableOutput":true}}}},"responses":{"200":{"description":"Successful paid assessment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BountyAssessment"},"example":{"version":"1.0.0","input":{"title":"Write a five-post launch thread","payoutUsd":250,"hoursEstimate":4,"daysToDeadline":5,"daysToPayout":14,"existingSubmissions":12,"fit":5,"paymentCertainty":4,"aiLeverage":5,"reuseValue":4,"cashCostUsd":0,"requiresAccount":true,"requiresPublicPost":false,"requiresPurchase":false,"agentAccessible":true,"humanSupportAvailable":false,"verifiableOutput":true},"result":{"score":86,"verdict":"pursue_now","payoutPerHourUsd":62.5,"expectedNetUsd":250,"estimatedSuccessProbability":0.615,"expectedValueUsd":153.75,"breakdown":{"paymentCertainty":{"score":4,"weight":20,"contribution":16},"fit":{"score":5,"weight":17,"contribution":17},"aiLeverage":{"score":5,"weight":15,"contribution":15},"reuseValue":{"score":4,"weight":14,"contribution":11.2},"timeToCash":{"score":4,"weight":12,"contribution":9.6},"payoutQuality":{"score":4,"weight":12,"contribution":9.6},"platformFriction":{"score":4,"weight":7,"contribution":5.6},"competition":{"score":4,"weight":3,"contribution":2.4}},"penalties":[],"hardStops":[],"strengths":["Payment path appears credible.","AI can materially compress delivery time.","Work can become a reusable asset or template.","Opportunity matches the operator's demonstrated strengths.","Headline payout per estimated hour is attractive."],"risks":["No major structural risk was declared; verify sponsor and rules manually."],"recommendedAction":"Claim or apply now. Produce a verifiable artifact first, then polish the submission around the sponsor's rubric."},"method":{"principle":"Weight payment certainty and fit above headline payout; prefer short, verifiable, AI-leveraged work that compounds into reusable assets.","weights":{"paymentCertainty":20,"fit":17,"aiLeverage":15,"reuseValue":14,"timeToCash":12,"payoutQuality":12,"platformFriction":7,"competition":3}}}}}},"400":{"description":"Invalid opportunity input; payment is not settled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required — $0.01 USDC on Base Mainnet","headers":{"Payment-Required":{"description":"Base64-encoded x402 v2 payment requirements","schema":{"type":"string"}}}}}}},"/api/bounty-score/example":{"get":{"operationId":"getBountyScoreExample","summary":"Inspect a free fixed input and output sample","tags":["Discovery"],"security":[],"responses":{"200":{"description":"Fixed sample generated by the production scoring core","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FixedExample"}}}}}}}},"components":{"schemas":{"BountyInput":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":160,"description":"Short opportunity title"},"payoutUsd":{"type":"number","minimum":0,"maximum":10000000,"description":"Headline payout in USD"},"hoursEstimate":{"type":"number","minimum":0.1,"maximum":10000,"description":"Estimated delivery hours"},"daysToDeadline":{"type":"number","minimum":0,"maximum":3650,"description":"Calendar days until deadline"},"daysToPayout":{"type":"number","minimum":0,"maximum":3650,"default":30,"description":"Expected days until payment"},"existingSubmissions":{"type":"number","minimum":0,"maximum":10000000,"default":0,"description":"Known competing submissions or applicants"},"fit":{"type":"number","minimum":1,"maximum":5,"default":3,"description":"Operator fit from 1 to 5"},"paymentCertainty":{"type":"number","minimum":1,"maximum":5,"default":3,"description":"Confidence that valid work gets paid, from 1 to 5"},"aiLeverage":{"type":"number","minimum":1,"maximum":5,"default":3,"description":"How much AI compresses delivery time, from 1 to 5"},"reuseValue":{"type":"number","minimum":1,"maximum":5,"default":3,"description":"Future template or asset reuse value, from 1 to 5"},"cashCostUsd":{"type":"number","minimum":0,"maximum":10000000,"default":0,"description":"Cash required before earning"},"requiresAccount":{"type":"boolean","default":false,"description":"Requires a platform account"},"requiresPublicPost":{"type":"boolean","default":false,"description":"Requires posting from a public social identity"},"requiresPurchase":{"type":"boolean","default":false,"description":"Requires buying an asset or product first"},"agentAccessible":{"type":"boolean","default":true,"description":"Can an autonomous agent execute the workflow directly"},"humanSupportAvailable":{"type":"boolean","default":false,"description":"A human can complete unavoidable access steps"},"verifiableOutput":{"type":"boolean","default":true,"description":"Completion can be proved with an artifact, link, or transaction"}},"required":["payoutUsd","hoursEstimate","daysToDeadline"]},"BountyAssessment":{"type":"object","properties":{"version":{"type":"string","const":"1.0.0"},"input":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":160,"description":"Short opportunity title"},"payoutUsd":{"type":"number","minimum":0,"maximum":10000000,"description":"Headline payout in USD"},"hoursEstimate":{"type":"number","minimum":0.1,"maximum":10000,"description":"Estimated delivery hours"},"daysToDeadline":{"type":"number","minimum":0,"maximum":3650,"description":"Calendar days until deadline"},"daysToPayout":{"type":"number","minimum":0,"maximum":3650,"default":30,"description":"Expected days until payment"},"existingSubmissions":{"type":"number","minimum":0,"maximum":10000000,"default":0,"description":"Known competing submissions or applicants"},"fit":{"type":"number","minimum":1,"maximum":5,"default":3,"description":"Operator fit from 1 to 5"},"paymentCertainty":{"type":"number","minimum":1,"maximum":5,"default":3,"description":"Confidence that valid work gets paid, from 1 to 5"},"aiLeverage":{"type":"number","minimum":1,"maximum":5,"default":3,"description":"How much AI compresses delivery time, from 1 to 5"},"reuseValue":{"type":"number","minimum":1,"maximum":5,"default":3,"description":"Future template or asset reuse value, from 1 to 5"},"cashCostUsd":{"type":"number","minimum":0,"maximum":10000000,"default":0,"description":"Cash required before earning"},"requiresAccount":{"type":"boolean","default":false,"description":"Requires a platform account"},"requiresPublicPost":{"type":"boolean","default":false,"description":"Requires posting from a public social identity"},"requiresPurchase":{"type":"boolean","default":false,"description":"Requires buying an asset or product first"},"agentAccessible":{"type":"boolean","default":true,"description":"Can an autonomous agent execute the workflow directly"},"humanSupportAvailable":{"type":"boolean","default":false,"description":"A human can complete unavoidable access steps"},"verifiableOutput":{"type":"boolean","default":true,"description":"Completion can be proved with an artifact, link, or transaction"}},"required":["payoutUsd","hoursEstimate","daysToDeadline"]},"result":{"type":"object","properties":{"score":{"type":"integer","minimum":0,"maximum":100},"verdict":{"type":"string","enum":["pursue_now","pursue_if_capacity","watch_or_reframe","skip"]},"payoutPerHourUsd":{"type":"number"},"expectedNetUsd":{"type":"number"},"estimatedSuccessProbability":{"type":"number","minimum":0,"maximum":1},"expectedValueUsd":{"type":"number"},"breakdown":{"type":"object","additionalProperties":{"type":"object","properties":{"score":{"type":"number","minimum":1,"maximum":5},"weight":{"type":"number","minimum":0,"maximum":100},"contribution":{"type":"number","minimum":0,"maximum":100}},"required":["score","weight","contribution"]}},"penalties":{"type":"array","items":{"type":"object","properties":{"reason":{"type":"string"},"points":{"type":"number"}},"required":["reason","points"]}},"hardStops":{"type":"array","items":{"type":"string"}},"strengths":{"type":"array","items":{"type":"string"}},"risks":{"type":"array","items":{"type":"string"}},"recommendedAction":{"type":"string"}},"required":["score","verdict","payoutPerHourUsd","expectedNetUsd","estimatedSuccessProbability","expectedValueUsd","breakdown","penalties","hardStops","strengths","risks","recommendedAction"]},"method":{"type":"object","properties":{"principle":{"type":"string"},"weights":{"type":"object","additionalProperties":{"type":"number"}}},"required":["principle","weights"]}},"required":["version","input","result","method"]},"FixedExample":{"type":"object","properties":{"free":{"type":"boolean","const":true},"kind":{"type":"string","const":"fixed-example"},"input":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":160,"description":"Short opportunity title"},"payoutUsd":{"type":"number","minimum":0,"maximum":10000000,"description":"Headline payout in USD"},"hoursEstimate":{"type":"number","minimum":0.1,"maximum":10000,"description":"Estimated delivery hours"},"daysToDeadline":{"type":"number","minimum":0,"maximum":3650,"description":"Calendar days until deadline"},"daysToPayout":{"type":"number","minimum":0,"maximum":3650,"default":30,"description":"Expected days until payment"},"existingSubmissions":{"type":"number","minimum":0,"maximum":10000000,"default":0,"description":"Known competing submissions or applicants"},"fit":{"type":"number","minimum":1,"maximum":5,"default":3,"description":"Operator fit from 1 to 5"},"paymentCertainty":{"type":"number","minimum":1,"maximum":5,"default":3,"description":"Confidence that valid work gets paid, from 1 to 5"},"aiLeverage":{"type":"number","minimum":1,"maximum":5,"default":3,"description":"How much AI compresses delivery time, from 1 to 5"},"reuseValue":{"type":"number","minimum":1,"maximum":5,"default":3,"description":"Future template or asset reuse value, from 1 to 5"},"cashCostUsd":{"type":"number","minimum":0,"maximum":10000000,"default":0,"description":"Cash required before earning"},"requiresAccount":{"type":"boolean","default":false,"description":"Requires a platform account"},"requiresPublicPost":{"type":"boolean","default":false,"description":"Requires posting from a public social identity"},"requiresPurchase":{"type":"boolean","default":false,"description":"Requires buying an asset or product first"},"agentAccessible":{"type":"boolean","default":true,"description":"Can an autonomous agent execute the workflow directly"},"humanSupportAvailable":{"type":"boolean","default":false,"description":"A human can complete unavoidable access steps"},"verifiableOutput":{"type":"boolean","default":true,"description":"Completion can be proved with an artifact, link, or transaction"}},"required":["payoutUsd","hoursEstimate","daysToDeadline"]},"output":{"type":"object","properties":{"version":{"type":"string","const":"1.0.0"},"input":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":160,"description":"Short opportunity title"},"payoutUsd":{"type":"number","minimum":0,"maximum":10000000,"description":"Headline payout in USD"},"hoursEstimate":{"type":"number","minimum":0.1,"maximum":10000,"description":"Estimated delivery hours"},"daysToDeadline":{"type":"number","minimum":0,"maximum":3650,"description":"Calendar days until deadline"},"daysToPayout":{"type":"number","minimum":0,"maximum":3650,"default":30,"description":"Expected days until payment"},"existingSubmissions":{"type":"number","minimum":0,"maximum":10000000,"default":0,"description":"Known competing submissions or applicants"},"fit":{"type":"number","minimum":1,"maximum":5,"default":3,"description":"Operator fit from 1 to 5"},"paymentCertainty":{"type":"number","minimum":1,"maximum":5,"default":3,"description":"Confidence that valid work gets paid, from 1 to 5"},"aiLeverage":{"type":"number","minimum":1,"maximum":5,"default":3,"description":"How much AI compresses delivery time, from 1 to 5"},"reuseValue":{"type":"number","minimum":1,"maximum":5,"default":3,"description":"Future template or asset reuse value, from 1 to 5"},"cashCostUsd":{"type":"number","minimum":0,"maximum":10000000,"default":0,"description":"Cash required before earning"},"requiresAccount":{"type":"boolean","default":false,"description":"Requires a platform account"},"requiresPublicPost":{"type":"boolean","default":false,"description":"Requires posting from a public social identity"},"requiresPurchase":{"type":"boolean","default":false,"description":"Requires buying an asset or product first"},"agentAccessible":{"type":"boolean","default":true,"description":"Can an autonomous agent execute the workflow directly"},"humanSupportAvailable":{"type":"boolean","default":false,"description":"A human can complete unavoidable access steps"},"verifiableOutput":{"type":"boolean","default":true,"description":"Completion can be proved with an artifact, link, or transaction"}},"required":["payoutUsd","hoursEstimate","daysToDeadline"]},"result":{"type":"object","properties":{"score":{"type":"integer","minimum":0,"maximum":100},"verdict":{"type":"string","enum":["pursue_now","pursue_if_capacity","watch_or_reframe","skip"]},"payoutPerHourUsd":{"type":"number"},"expectedNetUsd":{"type":"number"},"estimatedSuccessProbability":{"type":"number","minimum":0,"maximum":1},"expectedValueUsd":{"type":"number"},"breakdown":{"type":"object","additionalProperties":{"type":"object","properties":{"score":{"type":"number","minimum":1,"maximum":5},"weight":{"type":"number","minimum":0,"maximum":100},"contribution":{"type":"number","minimum":0,"maximum":100}},"required":["score","weight","contribution"]}},"penalties":{"type":"array","items":{"type":"object","properties":{"reason":{"type":"string"},"points":{"type":"number"}},"required":["reason","points"]}},"hardStops":{"type":"array","items":{"type":"string"}},"strengths":{"type":"array","items":{"type":"string"}},"risks":{"type":"array","items":{"type":"string"}},"recommendedAction":{"type":"string"}},"required":["score","verdict","payoutPerHourUsd","expectedNetUsd","estimatedSuccessProbability","expectedValueUsd","breakdown","penalties","hardStops","strengths","risks","recommendedAction"]},"method":{"type":"object","properties":{"principle":{"type":"string"},"weights":{"type":"object","additionalProperties":{"type":"number"}}},"required":["principle","weights"]}},"required":["version","input","result","method"]}},"required":["free","kind","input","output"]},"Health":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"service":{"type":"string","const":"Compounder Market API"},"version":{"type":"string","const":"0.1.0"},"network":{"type":"string","const":"eip155:8453"},"payTo":{"type":"string","const":"0xc7A7563793C3aeaCA9177a4aa2e4fd7C01F7Eb35"}},"required":["ok","service","version","network","payTo"]},"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}