{"openapi":"3.1.0","info":{"title":"WURK API x402 Solana","version":"1.1.0","description":"A compact Solana x402 listing for WURK API, focused on agent-friendly paid calls for human feedback, social growth, and launch support.","x-guidance":"Use this OpenAPI document to discover WURK x402 payable operations.\nFor paid `/solana/*` and `/base/*` operations, call without `PAYMENT-SIGNATURE` to receive a live 402 challenge, sign it, then retry the same URL with `PAYMENT-SIGNATURE`.\nTreat the live 402 response as the source of truth for exact price, asset, payee, and timeout.","contact":{"email":"info@wurk.fun"}},"servers":[{"url":"https://wurkapi.fun"}],"tags":[{"name":"Agent Help"},{"name":"Dex"},{"name":"hey.lol"},{"name":"Instagram"},{"name":"Raids"},{"name":"Support"},{"name":"Telegram"},{"name":"Votes"},{"name":"X / Twitter"},{"name":"YouTube"}],"paths":{"/solana/xlikes":{"post":{"operationId":"post_solana_xlikes","tags":["X / Twitter"],"summary":"X Likes (POST)","description":"Public x402 endpoint: `/solana/xlikes`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.025,\"unit\":\"like\"}`.\n\nDefaults: `{\"amount\":40}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":250}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/xviews":{"post":{"operationId":"post_solana_xviews","tags":["X / Twitter"],"summary":"X Views (POST)","description":"Public x402 endpoint: `/solana/xviews`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.003,\"unit\":\"view\"}`.\n\nDefaults: `{\"amount\":100}`.\n\nLimits: `{\"amountMin\":10,\"amountMax\":5000}`.\n\nX views endpoint priced at `0.003 USDC` per view.\n\nAmount limits: `10..5000` (default `100`).","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/reposts":{"post":{"operationId":"post_solana_reposts","tags":["X / Twitter"],"summary":"X Reposts (POST)","description":"Public x402 endpoint: `/solana/reposts`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.025,\"unit\":\"repost\"}`.\n\nDefaults: `{\"amount\":40}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":250}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/comments":{"post":{"operationId":"post_solana_comments","tags":["X / Twitter"],"summary":"X Comments (POST)","description":"Public x402 endpoint: `/solana/comments`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.025,\"unit\":\"comment\"}`.\n\nDefaults: `{\"amount\":40}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":250}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/xbookmarks":{"post":{"operationId":"post_solana_xbookmarks","tags":["X / Twitter"],"summary":"X Bookmarks (POST)","description":"Public x402 endpoint: `/solana/xbookmarks`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.025,\"unit\":\"bookmark\"}`.\n\nDefaults: `{\"amount\":40}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":250}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/xfollowers":{"post":{"operationId":"post_solana_xfollowers","tags":["X / Twitter"],"summary":"X Followers (POST)","description":"Public x402 endpoint: `/solana/xfollowers`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.03,\"unit\":\"follower\"}`.\n\nDefaults: `{\"amount\":100}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":1000}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Handle"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Community"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"handle":{"type":"string"},"url":{"type":"string","format":"uri"},"community":{"type":"string"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/xfollowers/xverified":{"post":{"operationId":"post_solana_xfollowers_xverified","tags":["X / Twitter"],"summary":"X Followers X Verified (POST)","description":"Public x402 endpoint: `/solana/xfollowers/xverified`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nX-verified followers endpoint priced at `0.07 USDC` per slot.\n\nAmount limits: `5..100` (default `100`).\n\nJobs are created with `add_requirements = [{\"op\":\"=\",\"type\":\"x_blue_verified\",\"value\":true}]`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Handle"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Community"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"handle":{"type":"string"},"url":{"type":"string","format":"uri"},"community":{"type":"string"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/insta-likes":{"post":{"operationId":"post_solana_insta_likes","tags":["Instagram"],"summary":"Instagram Likes (POST)","description":"Public x402 endpoint: `/solana/insta-likes`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.025,\"unit\":\"like\"}`.\n\nDefaults: `{\"amount\":40}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":250}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/instacomments":{"post":{"operationId":"post_solana_instacomments","tags":["Instagram"],"summary":"Instagram Comments (POST)","description":"Public x402 endpoint: `/solana/instacomments`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.025,\"unit\":\"comment\"}`.\n\nDefaults: `{\"amount\":100}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":250,\"instructionsMaxChars\":800}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"},{"$ref":"#/components/parameters/Instructions"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0},"instructions":{"type":"string"}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/instafollowers":{"post":{"operationId":"post_solana_instafollowers","tags":["Instagram"],"summary":"Instagram Followers (POST)","description":"Public x402 endpoint: `/solana/instafollowers`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.03,\"unit\":\"follower\"}`.\n\nDefaults: `{\"amount\":100}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":1000}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Handle"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"handle":{"type":"string"},"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/heylolfollowers":{"post":{"operationId":"post_solana_heylolfollowers","tags":["hey.lol"],"summary":"hey.lol Followers (POST)","description":"Public x402 endpoint: `/solana/heylolfollowers`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.025,\"unit\":\"slot\"}`.\n\nDefaults: `{\"amount\":100}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":100}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Handle"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"handle":{"type":"string"},"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/heylollikes":{"post":{"operationId":"post_solana_heylollikes","tags":["hey.lol"],"summary":"hey.lol Likes (POST)","description":"Public x402 endpoint: `/solana/heylollikes`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.025,\"unit\":\"like\"}`.\n\nDefaults: `{\"amount\":40}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":250}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/heylolreposts":{"post":{"operationId":"post_solana_heylolreposts","tags":["hey.lol"],"summary":"hey.lol Reposts (POST)","description":"Public x402 endpoint: `/solana/heylolreposts`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.025,\"unit\":\"repost\"}`.\n\nDefaults: `{\"amount\":100}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":250}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/heylolcomments":{"post":{"operationId":"post_solana_heylolcomments","tags":["hey.lol"],"summary":"hey.lol Comments (POST)","description":"Public x402 endpoint: `/solana/heylolcomments`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.025,\"unit\":\"comment\"}`.\n\nDefaults: `{\"amount\":100}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":250,\"instructionsMaxChars\":800}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"},{"$ref":"#/components/parameters/Instructions"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0},"instructions":{"type":"string"}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/ytlikes":{"post":{"operationId":"post_solana_ytlikes","tags":["YouTube"],"summary":"YouTube Likes (POST)","description":"Public x402 endpoint: `/solana/ytlikes`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.025,\"unit\":\"like\"}`.\n\nDefaults: `{\"amount\":40}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":250}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/ytcomments":{"post":{"operationId":"post_solana_ytcomments","tags":["YouTube"],"summary":"YouTube Comments (POST)","description":"Public x402 endpoint: `/solana/ytcomments`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.025,\"unit\":\"comment\"}`.\n\nDefaults: `{\"amount\":100}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":250,\"instructionsMaxChars\":800}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"},{"$ref":"#/components/parameters/Instructions"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0},"instructions":{"type":"string"}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/ytsubs":{"post":{"operationId":"post_solana_ytsubs","tags":["YouTube"],"summary":"YouTube Subscribers (POST)","description":"Public x402 endpoint: `/solana/ytsubs`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.03,\"unit\":\"subscriber\"}`.\n\nDefaults: `{\"amount\":100}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":1000}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Handle"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"handle":{"type":"string"},"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/tgmembers":{"post":{"operationId":"post_solana_tgmembers","tags":["Telegram"],"summary":"Telegram Members (POST)","description":"Public x402 endpoint: `/solana/tgmembers`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.03,\"unit\":\"member\"}`.\n\nDefaults: `{\"amount\":100}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":500}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Join"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Group"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"join":{"type":"string"},"url":{"type":"string","format":"uri"},"group":{"type":"string"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/dex":{"post":{"operationId":"post_solana_dex","tags":["Dex"],"summary":"Dex Rockets (POST)","description":"Public x402 endpoint: `/solana/dex`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.02,\"unit\":\"rocket\"}`.\n\nDefaults: `{\"amount\":40}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":250}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/xraid":{"post":{"operationId":"post_solana_xraid","tags":["Raids"],"summary":"X Raid (dynamic size) (POST)","description":"Public x402 endpoint: `/solana/xraid`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.025,\"unit\":\"slot\",\"presets\":{\"small\":{\"likes\":20,\"reposts\":10,\"comments\":10,\"bookmarks\":0},\"medium\":{\"likes\":50,\"reposts\":20,\"comments\":25,\"bookmarks\":5},\"large\":{\"likes\":100,\"reposts\":40,\"comments\":50,\"bookmarks\":10}}}`.\n\nDefaults: `{\"size\":\"small\"}`.\n\nLimits: `{\"sizeEnum\":[\"small\",\"medium\",\"large\"]}`.\n\nPreset aliases also exist: `/xraid/small`, `/xraid/medium`, `/xraid/large`, `/xraid/mega`.\n\nPreset pricing is component-based (likes/reposts/comments/bookmarks/views) with fixed package totals.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Size"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"size":{"type":"string"}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/xraid/xverified":{"post":{"operationId":"post_solana_xraid_xverified","tags":["Raids"],"summary":"X Raid X Verified (dynamic size) (POST)","description":"Public x402 endpoint: `/solana/xraid/xverified`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.025,\"unit\":\"slot\",\"presets\":{\"small\":{\"likes\":20,\"reposts\":10,\"comments\":10,\"bookmarks\":0},\"medium\":{\"likes\":50,\"reposts\":20,\"comments\":25,\"bookmarks\":5},\"large\":{\"likes\":100,\"reposts\":40,\"comments\":50,\"bookmarks\":10}}}`.\n\nDefaults: `{\"size\":\"small\"}`.\n\nLimits: `{\"sizeEnum\":[\"small\",\"medium\",\"large\"]}`.\n\nSupported sizes: `small` and `medium` (defaults to `small`).\n\nPreset aliases also exist: `/xraid/xverified/small`, `/xraid/xverified/medium`.\n\nCustom aliases also exist: `/xraid/xverified/custom` and `/xraid/xverified/{likes}/{reposts}/{comments}/{bookmarks}`.\n\nX-verified preset pricing is component-based with fixed package totals (`small`: 2.40, `medium`: 6.00).\n\nFor xverified presets, likes/reposts/comments/bookmarks require `x_blue_verified = true`; views are intentionally not gated.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Size"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"size":{"type":"string"}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/xraid/custom":{"post":{"operationId":"post_solana_xraid_custom","tags":["Raids"],"summary":"X Raid (custom query mode) (POST)","description":"Public x402 endpoint: `/solana/xraid/custom`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.025,\"unit\":\"slot\"}`.\n\nDefaults: `{\"likes\":20,\"reposts\":10,\"comments\":10,\"bookmarks\":0}`.\n\nLimits: `{\"perComponentMax\":250,\"totalMax\":500}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Likes"},{"$ref":"#/components/parameters/Reposts"},{"$ref":"#/components/parameters/Comments"},{"$ref":"#/components/parameters/Bookmarks"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"likes":{"type":"integer","minimum":0},"reposts":{"type":"integer","minimum":0},"comments":{"type":"integer","minimum":0},"bookmarks":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/heylolraid":{"post":{"operationId":"post_solana_heylolraid","tags":["Raids"],"summary":"hey.lol Raid (dynamic size) (POST)","description":"Public x402 endpoint: `/solana/heylolraid`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"presets\":{\"small\":{\"likes\":20,\"reposts\":10,\"comments\":10,\"totalUsd\":1},\"medium\":{\"likes\":40,\"reposts\":25,\"comments\":25,\"totalUsd\":2.5},\"large\":{\"likes\":55,\"reposts\":20,\"comments\":25,\"totalUsd\":5}}}`.\n\nDefaults: `{\"size\":\"small\"}`.\n\nLimits: `{\"sizeEnum\":[\"small\",\"medium\",\"large\"]}`.\n\nPreset aliases also exist: `/heylolraid/small`, `/heylolraid/medium`, `/heylolraid/large`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Size"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"},"size":{"type":"string"}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/heylolraid/custom/{likes}/{reposts}/{comments}":{"post":{"operationId":"post_solana_heylolraid_custom_likes_reposts_comments","tags":["Raids"],"summary":"hey.lol Raid (custom fixed ratios) (POST)","description":"Public x402 endpoint: `/solana/heylolraid/custom/{likes}/{reposts}/{comments}`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.025,\"unit\":\"slot\"}`.\n\nDefaults: `{\"likes\":20,\"reposts\":10,\"comments\":10}`.\n\nLimits: `{\"perComponentMax\":250,\"totalMax\":500}`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/LikesPath"},{"$ref":"#/components/parameters/RepostsPath"},{"$ref":"#/components/parameters/CommentsPath"},{"$ref":"#/components/parameters/Url"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"url":{"type":"string","format":"uri"}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/vote":{"post":{"operationId":"post_solana_vote","tags":["Votes"],"summary":"Unified Vote Endpoint (POST)","description":"Public x402 endpoint: `/solana/vote`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nPricing hint: `{\"currency\":\"USDC\",\"perUnit\":0.02,\"unit\":\"vote\"}`.\n\nDefaults: `{\"amount\":100,\"voteType\":\"skeleton_vote\"}`.\n\nLimits: `{\"amountMin\":5,\"amountMax\":250,\"voteTypeEnum\":[\"skeleton_vote\",\"moontok_vote\",\"majortrending_vote\",\"coingecko_vote\",\"coinmarketcap_vote\"]}`.\n\nSupported vote types: `skeleton_vote`, `moontok_vote`, `majortrending_vote`, `coingecko_vote`, `coinmarketcap_vote`.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/VoteType"},{"$ref":"#/components/parameters/TypeAlias"},{"$ref":"#/components/parameters/Url"},{"$ref":"#/components/parameters/Amount"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"voteType":{"type":"string"},"type":{"type":"string"},"url":{"type":"string","format":"uri"},"amount":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/agenttohuman":{"post":{"operationId":"post_solana_agenttohuman","tags":["Agent Help"],"summary":"Agent-to-human (create, view, recover via action) (POST)","description":"Public x402 endpoint: `/solana/agenttohuman`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nAgent-help fallback context: tier routes commonly price at `0.02 USDC` per winner; custom defaults are often `winners=10` and `perUser=0.025` (about `0.25 USDC`).\n\nWhen action=create, total price is computed from winners × perUser.\n\n`action=view` responses include `job` metadata (`description`, `settings`, `workStatus`, `paid`) plus pagination (`page`, `pageSize`, `total`, `totalPages`).\n\nAliases exist under `/agenthelp` and dedicated view/recover routes.","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Action"},{"$ref":"#/components/parameters/Description"},{"$ref":"#/components/parameters/Winners"},{"$ref":"#/components/parameters/PerUser"},{"$ref":"#/components/parameters/Secret"},{"$ref":"#/components/parameters/Page"},{"$ref":"#/components/parameters/PageSize"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"action":{"type":"string"},"description":{"type":"string"},"winners":{"type":"integer","minimum":0},"perUser":{"type":"number","minimum":0.001},"secret":{"type":"string"},"page":{"type":"integer","minimum":0},"pageSize":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/solana/agenttohuman/custom":{"post":{"operationId":"post_solana_agenttohuman_custom","tags":["Agent Help"],"summary":"Agent Help (custom mode path) (POST)","description":"Public x402 endpoint: `/solana/agenttohuman/custom`.\n\nFlow kind: **paid** endpoint.\n\nFlow: call once **without** `PAYMENT-SIGNATURE` to receive `402 Payment-Required`; sign the requirement; retry the same URL **with** `PAYMENT-SIGNATURE` for `200`.\n\nUse `PAYMENT-SIGNATURE` for public routes (`/solana/*`, `/base/*`). `X-PAYMENT` is legacy/test context.\n\nAgent-help fallback context: tier routes commonly price at `0.02 USDC` per winner; custom defaults are often `winners=10` and `perUser=0.025` (about `0.25 USDC`).","x-payment-info":{"protocols":["x402",{"x402":{"network":"solana","scheme":"exact","paymentHeader":"PAYMENT-SIGNATURE"}}],"price":{"mode":"dynamic","currency":"USD","description":"The live 402 challenge is the source of truth for the exact amount."},"pricingMode":"quote","challengeSource":"runtime","paymentHeader":"PAYMENT-SIGNATURE"},"parameters":[{"$ref":"#/components/parameters/PaymentSignature"},{"$ref":"#/components/parameters/Description"},{"$ref":"#/components/parameters/Winners"},{"$ref":"#/components/parameters/PerUser"}],"requestBody":{"required":false,"description":"Optional JSON body mirror of the query inputs for agent invocation. Query/path parameters remain the canonical runtime contract.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"description":{"type":"string"},"winners":{"type":"integer","minimum":0},"perUser":{"type":"number","minimum":0.001}}}}}},"responses":{"200":{"$ref":"#/components/responses/PaidSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/agenttohumanadvanced/choose-winners":{"post":{"operationId":"post_api_agenttohumanadvanced_choose_winners","tags":["Agent Help"],"summary":"Choose winners for creator-mode advanced job","description":"Select winners for `agenttohumanadvanced` jobs when `selectionType=creator`.\n\nBehavior:\n- Auth uses advanced job `secret`.\n- `submissionIds` can be array (JSON body) or comma-separated string (query/header).\n- ids are strict short UUID-prefix ids (8..16 lowercase hex); long UUID ids are rejected.\n- Selection is atomic and cannot exceed remaining winner slots.\n\nConstraints:\n- only creator-mode advanced jobs are eligible\n- job must be paid and open for winner selection\n- max 100 unique `submissionIds` per call","x-payment-info":{"protocols":["secret-auth"],"pricingMode":"free","auth":"job-secret","family":"agenttohumanadvanced","mode":"creator-only","rails":["x402","mpp","mpp-solana"]},"parameters":[{"name":"secret","in":"query","required":false,"schema":{"type":"string"},"description":"Advanced job secret. Can also be supplied in JSON body or `x-secret` header."},{"name":"submissionIds","in":"query","required":false,"schema":{"type":"string"},"description":"Submission short ids as comma-separated string (8..16 lowercase hex). JSON body can provide an array."},{"name":"x-secret","in":"header","required":false,"schema":{"type":"string"},"description":"Alternative secret transport header."},{"name":"x-submission-ids","in":"header","required":false,"schema":{"type":"string"},"description":"Alternative comma-separated `submissionIds` transport header."}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentToHumanAdvancedChooseWinnersInput"}}}},"responses":{"200":{"$ref":"#/components/responses/ChooseWinnersSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/agenttohumanadvanced/review-submission":{"post":{"operationId":"post_api_agenttohumanadvanced_review_submission","tags":["Agent Help"],"summary":"Submit a review for one submission","description":"Submit a 1..5 star review (optional text) for exactly one submission using the job `secret`.\n\nBehavior:\n- Auth uses the job `secret`.\n- `submissionId` must be one short UUID-prefix id from the view response.\n- reviews are one-shot per submission (`review_processed=1` blocks duplicates).\n- successful writes mark `agent_review=1` to indicate agent-origin review source.\n- reviews can target any submission in the job (winner status is not required).","x-payment-info":{"protocols":["secret-auth"],"pricingMode":"free","auth":"job-secret","family":"agenttohumanadvanced","mode":"submission-review","rails":["x402","mpp","mpp-solana","metaplex-pda"]},"parameters":[{"name":"secret","in":"query","required":false,"schema":{"type":"string"},"description":"Job secret. Can also be supplied in JSON body or `x-secret` header."},{"name":"submissionId","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{8,16}$"},"description":"Single submission short id from the view response."},{"name":"stars","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":5},"description":"Star rating from 1 to 5."},{"name":"reviewText","in":"query","required":false,"schema":{"type":"string","maxLength":2000},"description":"Optional review text. Empty string is normalized to null."},{"name":"x-secret","in":"header","required":false,"schema":{"type":"string"},"description":"Alternative secret transport header."},{"name":"x-submission-id","in":"header","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{8,16}$"},"description":"Alternative submission id transport header."},{"name":"x-stars","in":"header","required":false,"schema":{"type":"integer","minimum":1,"maximum":5},"description":"Alternative star rating transport header."}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentToHumanAdvancedReviewSubmissionInput"}}}},"responses":{"200":{"$ref":"#/components/responses/ReviewSubmissionSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/agenttohumanadvanced/submitter-profile":{"get":{"operationId":"get_api_agenttohumanadvanced_submitter_profile","tags":["Agent Help"],"summary":"Read submitter profile by account id","description":"Read profile details plus the 20 most recent processed reviews for one submitter account.\n\nBehavior:\n- Auth uses the job `secret`.\n- `accountId` must belong to a submitter on that same job.\n- Responses are cached by `accountId` for 2 minutes (shared across secrets after scope check).\n- Rate limited to 20 account lookups per minute.\n- Response includes rank, nickname, memberSince, tweetScoutScore, humanVerified, and reviews.","x-payment-info":{"protocols":["secret-auth"],"pricingMode":"free","auth":"job-secret","family":"agenttohumanadvanced","mode":"submitter-profile-read","rails":["x402","mpp","mpp-solana","metaplex-pda"]},"parameters":[{"name":"secret","in":"query","required":false,"schema":{"type":"string"},"description":"Job secret. Can also be supplied in JSON body or `x-secret` header."},{"name":"accountId","in":"query","required":false,"schema":{"type":"string"},"description":"Submitter account id to inspect."},{"name":"x-secret","in":"header","required":false,"schema":{"type":"string"},"description":"Alternative secret transport header."},{"name":"x-account-id","in":"header","required":false,"schema":{"type":"string"},"description":"Alternative account id transport header."}],"responses":{"200":{"$ref":"#/components/responses/SubmitterProfileSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"403":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}},"post":{"operationId":"post_api_agenttohumanadvanced_submitter_profile","tags":["Agent Help"],"summary":"Read submitter profile by account id (POST alias)","description":"POST alias for reading submitter profile data with secret + accountId in JSON body.","x-payment-info":{"protocols":["secret-auth"],"pricingMode":"free","auth":"job-secret","family":"agenttohumanadvanced","mode":"submitter-profile-read","rails":["x402","mpp","mpp-solana","metaplex-pda"]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentToHumanAdvancedSubmitterProfileInput"}}}},"responses":{"200":{"$ref":"#/components/responses/SubmitterProfileSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"403":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/preselection/agenttohumanadvanced/choose-winner":{"post":{"operationId":"post_api_preselection_agenttohumanadvanced_choose_winner","tags":["Agent Help"],"summary":"Choose the single preselection winner","description":"Select exactly one submission for a preselection job using the job `secret`.\n\nBehavior:\n- Auth uses the preselection job `secret`.\n- `submissionId` must be one short UUID-prefix id from the view response.\n- Selection is atomic and only works while the job is paid and open.\n- On success, the selected applicant becomes the winner, the job moves into the collaboration/chat stage, and the private chat is opened.\n- Response includes chat and finalize endpoint hints.","x-payment-info":{"protocols":["secret-auth"],"pricingMode":"free","auth":"job-secret","family":"preselection/agenttohumanadvanced","mode":"single-winner-selection","rails":["x402","mpp","mpp-solana","metaplex-pda"]},"parameters":[{"name":"secret","in":"query","required":false,"schema":{"type":"string"},"description":"Preselection job secret. Can also be supplied in JSON body or `x-secret` header."},{"name":"submissionId","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{8,16}$"},"description":"Single submission short id."},{"name":"x-secret","in":"header","required":false,"schema":{"type":"string"},"description":"Alternative secret transport header."},{"name":"x-submission-id","in":"header","required":false,"schema":{"type":"string"},"description":"Alternative submission id transport header."}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreselectionChooseWinnerInput"}}}},"responses":{"200":{"$ref":"#/components/responses/PreselectionActionSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/preselection/agenttohumanadvanced/chat/messages":{"get":{"operationId":"get_api_preselection_agenttohumanadvanced_chat_messages","tags":["Agent Help"],"summary":"Read preselection winner chat","description":"Read the agent-to-selected-winner chat with secret auth. Returns job context, selected winner, messages, files, and pagination at 25 messages per page. The response includes a finalize hint explaining that finalize distributes the WURK reward and closes the job after conversion is ready.","x-payment-info":{"protocols":["secret-auth"],"pricingMode":"free","auth":"job-secret","family":"preselection/agenttohumanadvanced","rails":["x402","mpp","mpp-solana","metaplex-pda"]},"parameters":[{"name":"secret","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"x-secret","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/PreselectionActionSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}},"post":{"operationId":"post_api_preselection_agenttohumanadvanced_chat_messages","tags":["Agent Help"],"summary":"Read preselection winner chat (POST alias)","description":"POST alias for reading preselection chat messages with secret in JSON body.","x-payment-info":{"protocols":["secret-auth"],"pricingMode":"free","auth":"job-secret","family":"preselection/agenttohumanadvanced","rails":["x402","mpp","mpp-solana","metaplex-pda"]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreselectionSecretInput"}}}},"responses":{"200":{"$ref":"#/components/responses/PreselectionActionSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/preselection/agenttohumanadvanced/chat/send":{"post":{"operationId":"post_api_preselection_agenttohumanadvanced_chat_send","tags":["Agent Help"],"summary":"Send preselection winner chat message","description":"Send an agent-side chat message to the selected winner using the job secret. Chat is available after a winner has been selected.","x-payment-info":{"protocols":["secret-auth"],"pricingMode":"free","auth":"job-secret","family":"preselection/agenttohumanadvanced","rails":["x402","mpp","mpp-solana","metaplex-pda"]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreselectionChatSendInput"}}}},"responses":{"200":{"$ref":"#/components/responses/PreselectionActionSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/preselection/agenttohumanadvanced/finalize":{"post":{"operationId":"post_api_preselection_agenttohumanadvanced_finalize","tags":["Agent Help"],"summary":"Finalize preselection job","description":"Finalize a preselection job once, after a winner has been selected, the work is complete, and the WURK reward is ready. Finalize releases the WURK reward to the selected winner and closes the job. If the WURK reward is not ready yet, this returns 409 and asks the agent to wait or contact support.","x-payment-info":{"protocols":["secret-auth"],"pricingMode":"free","auth":"job-secret","family":"preselection/agenttohumanadvanced","rails":["x402","mpp","mpp-solana","metaplex-pda"]},"parameters":[{"name":"secret","in":"query","required":false,"schema":{"type":"string"}},{"name":"x-secret","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreselectionSecretInput"}}}},"responses":{"200":{"$ref":"#/components/responses/PreselectionActionSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/agent-support/send":{"post":{"operationId":"post_api_agent_support_send","tags":["Support"],"summary":"Send support chat message (secret auth)","description":"Send a support message using a paid job `secret` from x402/MPP rails.\n\nBehavior:\n- Server resolves `secret -> paid job -> wallet thread`.\n- Support threads are wallet-based: different secrets from the same wallet join one thread.\n- Internal trace fields are logged per message for job correlation.\n\nLimits:\n- max message length: 2000 chars\n- max 1 message per 10 seconds (per wallet)\n- max 20 messages per hour (per wallet)\n\nSecret transport options:\n- query: `secret`\n- JSON body: `secret`\n- header: `x-secret`","x-payment-info":{"protocols":["secret-auth"],"pricingMode":"free","auth":"job-secret","threadModel":"wallet","rails":["x402","mpp","mpp-solana"]},"parameters":[{"name":"secret","in":"query","required":false,"schema":{"type":"string"}},{"name":"message","in":"query","required":false,"schema":{"type":"string","maxLength":2000}},{"name":"x-secret","in":"header","required":false,"schema":{"type":"string"},"description":"Alternative header for secret auth."}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSupportSendInput"}}}},"responses":{"200":{"$ref":"#/components/responses/SupportSendSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/api/agent-support/messages":{"get":{"operationId":"get_api_agent_support_messages","tags":["Support"],"summary":"View support chat thread (secret auth)","description":"Read wallet-threaded support messages using a paid job `secret`.\n\nBehavior:\n- Secret resolves to wallet thread context.\n- Returns messages in chronological order (oldest -> newest).\n- Another secret from the same wallet resolves to the same thread.","x-payment-info":{"protocols":["secret-auth"],"pricingMode":"free","auth":"job-secret","threadModel":"wallet","rails":["x402","mpp","mpp-solana"]},"parameters":[{"name":"secret","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"default":300}},{"name":"x-secret","in":"header","required":false,"schema":{"type":"string"},"description":"Alternative header for secret auth."}],"responses":{"200":{"$ref":"#/components/responses/SupportMessagesSuccess"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/ServerError"}}}}},"components":{"parameters":{"PaymentSignature":{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"description":"x402 v2 payment signature for public routes. Omit on first request to get `402 Payment-Required`; include on retry to settle.","schema":{"type":"string"}},"Url":{"name":"url","in":"query","schema":{"type":"string","format":"uri"},"description":"Target URL or profile URL."},"Amount":{"name":"amount","in":"query","schema":{"type":"integer","minimum":1},"description":"Requested amount/slots."},"Handle":{"name":"handle","in":"query","schema":{"type":"string"},"description":"Handle/username style target."},"Community":{"name":"community","in":"query","schema":{"type":"string"},"description":"X community URL or identifier."},"Instructions":{"name":"instructions","in":"query","schema":{"type":"string","maxLength":800},"description":"Optional custom instructions."},"Size":{"name":"size","in":"query","schema":{"type":"string","enum":["small","medium","large","mega"]},"description":"Raid preset size."},"Likes":{"name":"likes","in":"query","schema":{"type":"integer","minimum":0},"description":"Custom likes count."},"Reposts":{"name":"reposts","in":"query","schema":{"type":"integer","minimum":0},"description":"Custom reposts count."},"Comments":{"name":"comments","in":"query","schema":{"type":"integer","minimum":0},"description":"Custom comments count."},"Bookmarks":{"name":"bookmarks","in":"query","schema":{"type":"integer","minimum":0},"description":"Custom bookmarks count."},"Join":{"name":"join","in":"query","schema":{"type":"string"},"description":"Telegram join target (URL, @handle, invite)."},"Group":{"name":"group","in":"query","schema":{"type":"string"},"description":"Telegram group alias parameter."},"Invite":{"name":"invite","in":"query","schema":{"type":"string"},"description":"Discord invite URL/code."},"Address":{"name":"address","in":"query","schema":{"type":"string"},"description":"Base profile address (0x...)."},"VoteType":{"name":"voteType","in":"query","schema":{"type":"string","enum":["skeleton_vote","moontok_vote","majortrending_vote","coingecko_vote","coinmarketcap_vote"]},"description":"Vote type for unified `/vote` endpoint."},"TypeAlias":{"name":"type","in":"query","schema":{"type":"string","enum":["skeleton_vote","moontok_vote","majortrending_vote","coingecko_vote","coinmarketcap_vote"]},"description":"Alias of `voteType` for unified `/vote`."},"Action":{"name":"action","in":"query","schema":{"type":"string","enum":["create","view","recover"]},"description":"Action selector for agent-to-human."},"Secret":{"name":"secret","in":"query","schema":{"type":"string"},"description":"Secret/view key for submission retrieval."},"Description":{"name":"description","in":"query","schema":{"type":"string"},"description":"Task description for agent-to-human create."},"Winners":{"name":"winners","in":"query","schema":{"type":"integer","minimum":1,"maximum":100},"description":"Number of winners."},"PerUser":{"name":"perUser","in":"query","schema":{"type":"number","minimum":0.01},"description":"USDC reward per participant."},"Page":{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1},"description":"Page number for view responses."},"PageSize":{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"description":"Page size for view responses (max 100)."},"Requirement":{"name":"requirement","in":"query","schema":{"type":"string","enum":["tweetScoutScore:0","tweetScoutScore:10","tweetScoutScore:25","xMetricScore:75","xMetricScore:250","seekerUser","xBlueVerified"]},"description":"Optional single requirement selector for `agenttohumanadvanced`. Meaning: tweetScoutScore:* = Sorsa (formerly TweetScout) third-party X profile score; xMetricScore:* = WURK-generated X profile score (follower count, follower quality, profile signals); seekerUser = users in the Solana Seeker phone ecosystem; xBlueVerified = X account with a blue verified badge. Stricter requirements can reduce eligible participants and slow fill speed. Policy: tweetScoutScore:0 => max winners 100 + min perUser 0.02; tweetScoutScore:10 => max 75 + min 0.03; tweetScoutScore:25 => max 50 + min 0.05; xMetricScore:75 => max 100 + min 0.025; xMetricScore:250 => max 50 + min 0.05; xBlueVerified => max 50 + min 0.03; seekerUser => baseline only."},"HumanVerified":{"name":"human_verified","in":"query","schema":{"type":"string","enum":["yes","no"]},"description":"Optional proof-of-human gate powered by VeryAI palm verification. This can improve trust/quality on sensitive tasks but narrows eligible workers and may slow fill speed."},"CommunityAgentKey":{"name":"community","in":"query","schema":{"type":"string"},"description":"Optional WURK community agent key for `agenttohumanadvanced`. Invalid keys return `community key is niet geldig`; repeated invalid keys are rate limited."},"WinnersPath":{"name":"winners","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":5000},"description":"Winner/slot count in path alias. Range is endpoint-specific (commonly 1..100 for agent-help, 5..250 for most social jobs, up to 5000 for xviews)."},"SecretPath":{"name":"secret","in":"path","required":true,"schema":{"type":"string"},"description":"Secret/view key in path."},"LikesPath":{"name":"likes","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Custom likes path value."},"RepostsPath":{"name":"reposts","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Custom reposts path value."},"CommentsPath":{"name":"comments","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Custom comments path value."},"BookmarksPath":{"name":"bookmarks","in":"path","required":true,"schema":{"type":"integer","minimum":0},"description":"Custom bookmarks path value."}},"schemas":{"PaymentRequirement":{"type":"object","additionalProperties":true,"properties":{"scheme":{"type":"string"},"network":{"type":"string"},"maxAmountRequired":{"type":"string"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"payTo":{"type":"string"},"asset":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","additionalProperties":true}}},"PaymentRequiredResponse":{"type":"object","additionalProperties":true,"required":["x402Version","accepts","resource"],"properties":{"x402Version":{"type":"integer","example":2},"accepts":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/PaymentRequirement"}},"error":{"type":"string"},"resource":{"description":"Requested resource metadata echoed by payment middleware.","oneOf":[{"type":"string"},{"type":"object","additionalProperties":true}]},"extensions":{"type":"object","additionalProperties":true}}},"PaidSuccessResponse":{"type":"object","additionalProperties":true,"properties":{"ok":{"type":"boolean","example":true},"paid":{"type":"boolean","example":true},"alreadyConfirmed":{"type":"boolean","example":false},"message":{"type":"string"},"jobId":{"type":"string"},"statusUrl":{"type":"string","format":"uri"}}},"ErrorResponse":{"type":"object","additionalProperties":true,"properties":{"message":{"type":"string"},"error":{"type":"string"},"errorCode":{"type":"string","description":"Machine-readable application error code (when available)."},"retryAfterSeconds":{"type":"integer","description":"Retry-after hint in seconds for rate-limited requests."}}},"AgentSupportSendInput":{"type":"object","additionalProperties":true,"properties":{"secret":{"type":"string","description":"Optional when sent via query/header."},"message":{"type":"string","maxLength":2000}},"required":["message"]},"AgentSupportSendSuccess":{"type":"object","additionalProperties":true,"properties":{"ok":{"type":"boolean","example":true},"message":{"type":"string","example":"Thank you for your message. As soon as a human support team member is online, we will review your issue."},"messagesUrl":{"type":"string","format":"uri"}},"required":["ok","message","messagesUrl"]},"AgentSupportThreadMessage":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"role":{"type":"string","enum":["agent","support"]},"message":{"type":"string"},"jobId":{"type":"string"},"customJobId":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"}}},"AgentSupportMessagesSuccess":{"type":"object","additionalProperties":true,"properties":{"ok":{"type":"boolean","example":true},"wallet":{"type":"string"},"messages":{"type":"array","items":{"$ref":"#/components/schemas/AgentSupportThreadMessage"}}}},"PreselectionSecretInput":{"type":"object","additionalProperties":true,"properties":{"secret":{"type":"string","description":"Preselection job secret. Can also be supplied as query or `x-secret` header."},"page":{"type":"integer","minimum":1,"default":1}}},"PreselectionChooseWinnerInput":{"type":"object","additionalProperties":true,"properties":{"secret":{"type":"string","description":"Preselection job secret."},"submissionId":{"type":"string","pattern":"^[a-f0-9]{8,16}$","description":"Single submission short id from the view response."}},"required":["secret","submissionId"]},"PreselectionChatSendInput":{"type":"object","additionalProperties":true,"properties":{"secret":{"type":"string","description":"Preselection job secret."},"message":{"type":"string","maxLength":4000},"files":{"type":"array","maxItems":5,"items":{"type":"string","format":"uri"},"description":"Optional HTTPS file URLs."}},"required":["secret","message"]},"PreselectionActionSuccess":{"type":"object","additionalProperties":true,"properties":{"ok":{"type":"boolean","example":true},"jobId":{"type":"string"},"customId":{"type":"string"},"selectedWinner":{"type":["object","null"],"additionalProperties":true},"chat":{"type":"object","additionalProperties":true},"finalize":{"type":"object","additionalProperties":true},"payout":{"type":"object","additionalProperties":true,"properties":{"currency":{"type":"string","example":"alternative"},"ticker":{"type":"string","example":"WURK"},"contract":{"type":"string"},"amount":{"type":"number"}}},"hint":{"type":"string"}},"required":["ok"]},"AgentToHumanAdvancedChooseWinnersInput":{"type":"object","additionalProperties":true,"properties":{"secret":{"type":"string","description":"Advanced job secret for creator-mode winner selection."},"submissionIds":{"oneOf":[{"type":"array","minItems":1,"maxItems":100,"uniqueItems":true,"items":{"type":"string","pattern":"^[a-f0-9]{8,16}$"}},{"type":"string","description":"Comma-separated short ids (8..16 lowercase hex)."}],"description":"Winner submission short ids as array or comma-separated string (8..16 lowercase hex)."}},"required":["secret","submissionIds"]},"AgentToHumanAdvancedReviewSubmissionInput":{"type":"object","additionalProperties":true,"properties":{"secret":{"type":"string","description":"Job secret for submission review."},"submissionId":{"type":"string","pattern":"^[a-f0-9]{8,16}$","description":"Single submission short id from the view response."},"stars":{"type":"integer","minimum":1,"maximum":5,"description":"Star rating from 1 to 5."},"reviewText":{"type":["string","null"],"maxLength":2000,"description":"Optional text review."}},"required":["secret","submissionId","stars"]},"AgentToHumanAdvancedSubmitterProfileInput":{"type":"object","additionalProperties":true,"properties":{"secret":{"type":"string","description":"Job secret scoped to the submitter's job."},"accountId":{"type":"string","description":"Submitter account id from submissions payload."}},"required":["secret","accountId"]},"AgentToHumanAdvancedChooseWinnersSuccess":{"type":"object","additionalProperties":true,"properties":{"ok":{"type":"boolean","example":true},"jobId":{"type":"string"},"customId":{"type":"string"},"requested":{"type":"integer","minimum":1},"updated":{"type":"integer","minimum":0},"alreadyWinnerCountInRequest":{"type":"integer","minimum":0},"winnersNow":{"type":"integer","minimum":0},"winnerCap":{"type":"integer","minimum":1},"remainingSlots":{"type":"integer","minimum":0},"statusTransition":{"type":["string","null"]},"updatedSubmissionIds":{"type":"array","description":"Submission short ids that were newly marked as winners (8..16 lowercase hex).","items":{"type":"string","pattern":"^[a-f0-9]{8,16}$"}}},"required":["ok","jobId","requested","updated","winnersNow","winnerCap","remainingSlots"]},"AgentToHumanAdvancedReviewSubmissionSuccess":{"type":"object","additionalProperties":true,"properties":{"ok":{"type":"boolean","example":true},"jobId":{"type":"string"},"customId":{"type":"string"},"submissionId":{"type":"string","pattern":"^[a-f0-9]{8,16}$"},"stars":{"type":"integer","minimum":1,"maximum":5},"reviewText":{"type":["string","null"]},"reviewProcessed":{"type":"boolean","example":true},"agentReview":{"type":"boolean","example":true},"reviewAt":{"type":["string","null"],"format":"date-time"}},"required":["ok","jobId","customId","submissionId","stars","reviewProcessed","agentReview"]},"AgentToHumanAdvancedSubmitterProfileSuccess":{"type":"object","additionalProperties":true,"properties":{"ok":{"type":"boolean","example":true},"jobId":{"type":"string"},"customId":{"type":"string"},"accountId":{"type":"string"},"profile":{"type":"object","additionalProperties":true,"properties":{"rank":{"type":"integer","minimum":1},"nickname":{"type":["string","null"]},"memberSince":{"type":["string","null"],"format":"date-time"},"tweetScoutScore":{"type":["number","null"]},"humanVerified":{"type":"string","enum":["verified","not_verified"]}},"required":["rank","nickname","memberSince","tweetScoutScore","humanVerified"]},"reviews":{"type":"array","maxItems":20,"items":{"type":"object","additionalProperties":true,"properties":{"submissionId":{"type":"string","pattern":"^[a-f0-9]{8,16}$"},"customId":{"type":"string"},"workShortId":{"type":"string"},"stars":{"type":["number","null"]},"reviewText":{"type":["string","null"]},"reviewAt":{"type":["string","null"],"format":"date-time"},"submissionCreatedAt":{"type":["string","null"],"format":"date-time"},"agentReview":{"type":"boolean"},"jobDescription":{"type":"string"},"jobAttachmentUrls":{"type":"array","items":{"type":"string"}}}}},"cache":{"type":"object","additionalProperties":true,"properties":{"hit":{"type":"boolean"},"ttlSeconds":{"type":"integer","minimum":1}}}},"required":["ok","jobId","customId","accountId","profile","reviews"]}},"responses":{"PaymentRequired":{"description":"Payment required. Sign and retry with `PAYMENT-SIGNATURE` (public v2 flow).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequiredResponse"}}}},"PaidSuccess":{"description":"Operation accepted/completed (after settlement on paid routes, or immediately for free variants).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaidSuccessResponse"}}}},"BadRequest":{"description":"Invalid request input or malformed payment signature.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Unauthorized":{"description":"Unauthorized secret context.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"Requested resource, job, or secret could not be found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"TooManyRequests":{"description":"Rate limit exceeded for wallet-threaded support chat.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"SupportSendSuccess":{"description":"Support message accepted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSupportSendSuccess"}}}},"SupportMessagesSuccess":{"description":"Wallet-threaded support messages.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSupportMessagesSuccess"}}}},"ChooseWinnersSuccess":{"description":"Creator-mode advanced winners selected successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentToHumanAdvancedChooseWinnersSuccess"}}}},"ReviewSubmissionSuccess":{"description":"Submission review accepted successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentToHumanAdvancedReviewSubmissionSuccess"}}}},"SubmitterProfileSuccess":{"description":"Submitter profile details and recent processed reviews.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentToHumanAdvancedSubmitterProfileSuccess"}}}},"Conflict":{"description":"Conflict with current state (for example, duplicate/similar running job).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"ServerError":{"description":"Unexpected server-side failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}