{"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."},"servers":[{"url":"https://wurkapi.fun"}],"tags":[{"name":"Agent Help"},{"name":"Dex"},{"name":"Discord"},{"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/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/dcmembers":{"post":{"operationId":"post_solana_dcmembers","tags":["Discord"],"summary":"Discord Members (POST)","description":"Public x402 endpoint: `/solana/dcmembers`.\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\":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/Invite"},{"$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":{"invite":{"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/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`.","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-gated raid priced at `0.06 USDC` per slot with `x_blue_verified = true` job requirements.","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/xraid/scout/custom":{"post":{"operationId":"post_solana_xraid_scout_custom","tags":["Raids"],"summary":"X Raid Sorsa Score (custom query mode) (POST)","description":"Public x402 endpoint: `/solana/xraid/scout/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\nSorsa-gated custom raid priced at `0.05 USDC` per slot.\n\nOmitted count fields default to `0` on this sorsa-custom query route.\n\nEach non-zero component must be at least `5`, and at least one component must be `>= 5`.\n\nLegacy scout alias remains supported: `/xraid/scout/custom`.","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/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"]},"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. `yes` stores `reverify_on=1` and `human_verified_requirement=1` on work/work_custom; `no` keeps both at 0. 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`. If provided, the key must exist in `community_agent_keys.agent_key`; the matched `community_id` is stored in `work_custom.community`. Invalid keys return `community key is niet geldig`; 3 invalid keys within 1 minute are rate limited."},"WinnersPath":{"name":"winners","in":"path","required":true,"schema":{"type":"integer","minimum":1,"maximum":250},"description":"Winner/slot count in path alias. Range is endpoint-specific (commonly 1..100 for agent-help, 5..250 for social jobs)."},"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"}}}},"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"]},"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"]}},"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"}}}},"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"}}}}}}}