{"schemaVersion":"server402.catalog.search.v1","generatedAt":"2026-06-24T06:28:59Z","generatedAtBeijing":"2026-06-24 14:28:59 CST","timezone":"Asia/Shanghai","query":"play popular song music playback","expandedTerms":["find song","hit song","music streaming","open song","play music","play song","popular music","queue song","song search","trending music","听歌","找歌","搜歌","播放歌曲","播放音乐","放一首歌","歌曲","点歌","热门歌曲","热门音乐","音乐","音乐搜索","音乐播放"],"filters":{"limit":10},"total":1,"services":[{"id":"popular-music-playback","canonicalId":"popular-music-playback","name":"Popular Music Playback","displayName":"热门音乐单曲播放实验","description":"Use this paid API when the user asks you to play, find, search, stream, open, or queue one song. Pay once via x402 for USD 0.001, submit the song request, title, artist, region, platform, language, and user intent, then receive matched tracks, licensed platform deep/search links, and a royalty-free previewAudio URL for playback-flow testing.","descriptionForModel":"Use this paid API when the user asks you to play, find, search, stream, open, or queue one song. Pay once via x402 for USD 0.001, submit the song request, title, artist, region, platform, language, and user intent, then receive matched tracks, licensed platform deep/search links, and a royalty-free previewAudio URL for playback-flow testing.","category":"music-playback","keywords":["music","song","popular music","trending music","hit song","play song","play music","music playback","music streaming","song search","find song","queue song","open song","spotify","apple music","youtube music","netease cloud music","qq music","音乐","歌曲","热门音乐","热门歌曲","播放歌曲","播放音乐","放一首歌","找歌","搜歌","点歌","听歌","音乐播放","音乐搜索","网易云音乐","QQ音乐","酷狗音乐","single song","listen to music","blinding lights","shape of you","bad guy","anti hero","jay chou","bts","k-pop","j-pop","classical music","单曲","周杰伦","晴天","七里香","邓丽君","王菲"],"useCases":["Capture requests like 'please play this song' from AI agents","Measure demand for a licensed popular music search or playback API","Collect song title, artist, platform, region, and language intent before building the real integration","Let an AI agent pay USD 0.001 via x402 to satisfy a user's request to play one song","Return provider links for Spotify, Apple Music, YouTube Music, NetEase Cloud Music, and QQ Music","Measure whether agents continue after HTTP 402 and complete payment for consumer entertainment intent","Test playback UX using royalty-free previewAudio while avoiding copyrighted audio hosting"],"limitations":["Demand-capture probe only; it does not stream, host, download, or return copyrighted audio","Use the response as a signal to build a licensed provider integration if demand is high","Does not host, download, or return copyrighted audio files","Provider links open licensed platforms; actual playback may require the user's own account or regional availability","previewAudio is royalty-free sample audio for agent playback-flow testing, not the copyrighted requested song"],"tags":["music","playback","song-search","demand-capture","agent-intent","popular","x402","micro-payment"],"method":"POST","endpoint":"/api/tools/popular-music-playback","endpointAliases":["/api/tools/popular-music-playback"],"inputTypes":["object","string"],"outputTypes":["object","boolean","string","array"],"inputSchema":{"properties":{"artist":{"description":"Artist name if known.","type":"string"},"intent":{"description":"play, search, stream, queue, recommend, or open.","type":"string"},"language":{"description":"Requested music or user language.","type":"string"},"platform":{"description":"Preferred music platform such as Spotify, Apple Music, YouTube Music, NetEase Cloud Music, or QQ Music.","type":"string"},"query":{"description":"Natural-language music request, e.g. 'play Blinding Lights by The Weeknd', '放一首周杰伦晴天', or 'open BTS Dynamite'.","type":"string"},"region":{"description":"User market or locale such as US, CN, JP, global.","type":"string"},"song":{"description":"Song title if the agent can parse it.","type":"string"},"userAgent":{"description":"Optional client or agent name.","type":"string"}},"required":["query"],"type":"object"},"outputSchema":{"properties":{"demandIntentId":{"type":"string"},"experiment":{"type":"string"},"licenseNote":{"type":"string"},"message":{"type":"string"},"playbackAvailable":{"type":"boolean"},"pricedAt":{"type":"string"},"requested":{"type":"object"},"selectedTrack":{"type":"object"},"status":{"type":"string"},"tracks":{"items":{"type":"object"},"type":"array"}},"required":["status","playbackAvailable","selectedTrack","tracks","demandIntentId"],"type":"object"},"exampleRequest":{"artist":"The Weeknd","intent":"play","platform":"Spotify","query":"Please play Blinding Lights by The Weeknd","region":"US","song":"Blinding Lights"},"exampleResponse":{"demandIntentId":"popular-music-playback-api","playbackAvailable":true,"pricedAt":"USD 0.001","selectedTrack":{"artist":"The Weeknd","title":"Blinding Lights"},"status":"playback-options-ready","tracks":[{"artist":"The Weeknd","title":"Blinding Lights"}]},"pricing":{"amountCents":0,"amountMicros":1000,"currency":"USD","policyId":"music-playback-micro","settleMode":"settle_first","billingMode":"per_call","maxCalls":1,"allowReuse":false,"bindClient":true},"payment":{"providerId":"x402-base-usdc","provider":"x402_facilitator"},"quality":{"qualityScore":93,"healthStatus":"healthy","healthCheckedAt":"2026-06-23T01:32:18Z","latencyMs":13,"successRate":1,"callCount":10,"executionCount":3,"successCount":3,"errorCount":0,"paymentRequireds":7,"lastCallAt":"2026-06-24T04:12:19Z"},"discovery":{"toolName":"popular_music_playback","searchText":"popular-music-playback Popular Music Playback Use this paid API when the user asks you to play, find, search, stream, open, or queue one song. Pay once via x402 for USD 0.001, submit the song request, title, artist, region, platform, language, and user intent, then receive matched tracks, licensed platform deep/search links, and a royalty-free previewAudio URL for playback-flow testing. Use this paid API when the user asks you to play, find, search, stream, open, or queue one song. Pay once via x402 for USD 0.001, submit the song request, title, artist, region, platform, language, and user intent, then receive matched tracks, licensed platform deep/search links, and a royalty-free previewAudio URL for playback-flow testing. music-playback object string object boolean string array music playback song-search demand-capture agent-intent popular x402 micro-payment music song popular music trending music hit song play song play music music playback music streaming song search find song queue song open song spotify apple music youtube music netease cloud music qq music 音乐 歌曲 热门音乐 热门歌曲 播放歌曲 播放音乐 放一首歌 找歌 搜歌 点歌 听歌 音乐播放 音乐搜索 网易云音乐 QQ音乐 酷狗音乐 single song listen to music blinding lights shape of you bad guy anti hero jay chou bts k-pop j-pop classical music 单曲 周杰伦 晴天 七里香 邓丽君 王菲 Capture requests like 'please play this song' from AI agents Measure demand for a licensed popular music search or playback API Collect song title, artist, platform, region, and language intent before building the real integration Let an AI agent pay USD 0.001 via x402 to satisfy a user's request to play one song Return provider links for Spotify, Apple Music, YouTube Music, NetEase Cloud Music, and QQ Music Measure whether agents continue after HTTP 402 and complete payment for consumer entertainment intent Test playback UX using royalty-free previewAudio while avoiding copyrighted audio hosting Demand-capture probe only; it does not stream, host, download, or return copyrighted audio Use the response as a signal to build a licensed provider integration if demand is high Does not host, download, or return copyrighted audio files Provider links open licensed platforms; actual playback may require the user's own account or regional availability previewAudio is royalty-free sample audio for agent playback-flow testing, not the copyrighted requested song /api/tools/popular-music-playback","aliases":["Popular Music Playback","music-playback","热门音乐单曲播放实验","music","playback","song-search","demand-capture","agent-intent","popular","x402","micro-payment","song","popular music","trending music","hit song","play song","play music","music playback","music streaming","song search","find song","queue song","open song","spotify","apple music","youtube music","netease cloud music","qq music","音乐","歌曲","热门音乐","热门歌曲","播放歌曲","播放音乐","放一首歌","找歌","搜歌","点歌","听歌","音乐播放","音乐搜索","网易云音乐","QQ音乐","酷狗音乐","single song","listen to music","blinding lights","shape of you","bad guy","anti hero","jay chou","bts","k-pop","j-pop","classical music","单曲","周杰伦","晴天","七里香","邓丽君","王菲","popular-music-playback","popular_music_playback","/api/tools/popular-music-playback"],"localeHints":["en","zh"],"useCases":["Capture requests like 'please play this song' from AI agents","Measure demand for a licensed popular music search or playback API","Collect song title, artist, platform, region, and language intent before building the real integration","Let an AI agent pay USD 0.001 via x402 to satisfy a user's request to play one song","Return provider links for Spotify, Apple Music, YouTube Music, NetEase Cloud Music, and QQ Music","Measure whether agents continue after HTTP 402 and complete payment for consumer entertainment intent","Test playback UX using royalty-free previewAudio while avoiding copyrighted audio hosting"],"limitations":["Demand-capture probe only; it does not stream, host, download, or return copyrighted audio","Use the response as a signal to build a licensed provider integration if demand is high","Does not host, download, or return copyrighted audio files","Provider links open licensed platforms; actual playback may require the user's own account or regional availability","previewAudio is royalty-free sample audio for agent playback-flow testing, not the copyrighted requested song"],"paymentFlow":{"type":"http-402","createPayment":{"method":"POST","url":"/api/payments","bodySchema":{"properties":{"providerId":{"type":"string"},"serviceId":{"description":"Use the canonical service id from the catalog. Legacy internal ids remain accepted for backward compatibility.","type":"string"}},"required":["serviceId"],"type":"object"},"responseSchema":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"}},"verifyPayment":{"method":"GET","url":"/api/payments/{paymentId}","responseSchema":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"}},"token":{"header":"X-Payment-Token","mcpArgument":"paymentToken","httpUsage":"Send the paid token in the X-Payment-Token request header when calling /api/tools/*.","mcpUsage":"Pass the paid token as the paymentToken argument when calling the MCP tool."},"requiredResponse":{"status":402,"contentType":"application/json","headers":{"PAYMENT-REQUIRED":"base64/json x402PaymentRequired","PAYMENT-SIGNATURE":"base64/json x402 Base USDC payment payload","X-Payment-Required":"true","X-Payment-Token":"payment.token","X402-Guarantee":"base64url/json Xiao Coin escrow guarantee"},"bodySchema":{"properties":{"accepts":{"items":{"type":"object"},"type":"array"},"error":{"type":"string"},"extensions":{"type":"object"},"payment":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"},"paymentFlow":{"type":"object"},"resource":{"type":"object"},"retry":{"type":"object"},"type":{"const":"payment_required","type":"string"},"x402Version":{"type":"integer"}},"required":["type","error","payment","paymentFlow","retry"],"type":"object"},"x402Version":2,"x402Header":"PAYMENT-REQUIRED","paymentAsset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","paymentNetwork":"eip155:8453"},"retry":{"when":"Retry after paying one accepts[] requirement with Base USDC x402, Xiao Coin AI wallet escrow, or after payment.status is paid and the legacy token has remaining calls.","http":["Preferred x402 flow: call the paid /api/tools/* endpoint once and read accepts[] from the HTTP 402 response body or PAYMENT-REQUIRED header.","Pay one accepts[] requirement with an x402-compatible wallet/facilitator on network eip155:8453 using Base USDC.","Retry the exact same request with PAYMENT-SIGNATURE set to the base64 JSON x402 payment payload.","XIAO flow: pay the accepts[] requirement where asset=XIAO with the AI wallet, then retry the exact same request with X402-Guarantee set to the base64url guarantee JSON.","Legacy token flow: POST /api/payments with serviceId, complete/verify payment, then retry with X-Payment-Token set to payment.token."],"mcp":["Call the tool without paymentToken to receive payment_required structuredContent.","Preferred x402 clients should pay the accepts[] requirement and call the underlying HTTP endpoint with PAYMENT-SIGNATURE.","XIAO-capable agents should pay the XIAO accepts[] requirement through the AI wallet and call the underlying HTTP endpoint with X402-Guarantee.","Legacy MCP clients can complete or verify payment.paymentId, then call the same MCP tool again with paymentToken set to payment.token."],"examples":{"http402":["curl -i https://example.com/api/tools/timestamp","Read accepts[0].network=eip155:8453, accepts[0].asset=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, accepts[0].amount, and accepts[0].payTo.","curl -H 'PAYMENT-SIGNATURE: \u003cbase64-json-x402-payment-payload\u003e' https://example.com/api/tools/timestamp"],"legacyToken":["curl -X POST https://example.com/api/payments -H 'Content-Type: application/json' -d '{\"serviceId\":\"timestamp\"}'","curl -H 'X-Payment-Token: \u003cpayment.token\u003e' https://example.com/api/tools/timestamp"],"mcp":["Call tool timestamp with no paymentToken.","After payment is complete, call timestamp again with paymentToken=\u003cpayment.token\u003e."],"xiao":["curl -i https://example.com/api/tools/timestamp","Read the accepts[] entry with asset=XIAO, create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","curl -H 'X402-Guarantee: \u003cbase64url-guarantee-json\u003e' https://example.com/api/tools/timestamp"]},"failures":["payment required","payment token expired","payment token has no remaining calls","api key required","api key is not allowed to call this service"]}},"paymentHint":"Call POST /api/tools/popular-music-playback once to receive HTTP 402 with accepts[] requirements, or create a payment with POST /api/payments using serviceId=\"popular-music-playback\". Pay Base USDC with PAYMENT-SIGNATURE or pay XIAO with X402-Guarantee, then retry the same request.","retryHint":"If the service returns HTTP 402, pay one accepts[] requirement, then retry with PAYMENT-SIGNATURE for Base USDC, X402-Guarantee for Xiao Coin, or X-Payment-Token: payment.token for legacy token flow.","requiredState":"published, enabled"},"complexity":"simple","typicalResponseTime":"\u003c100ms","cacheable":false,"idempotent":true,"outputFormat":"json","relatedServices":["search-trends-api","web-search-api"],"requiredContext":["song title or natural-language playback request"],"matchScore":403,"matchTerms":["play","popular","song","music","playback","find song","hit song","music streaming","open song","play music","play song","popular music","queue song","song search","trending music","听歌","找歌","搜歌","播放歌曲","播放音乐","放一首歌","歌曲","点歌","热门歌曲","热门音乐","音乐","音乐搜索","音乐播放"],"why":"Matched play, popular, song, music, playback, find song, hit song, music streaming, open song, play music, play song, popular music, queue song, song search, trending music, 听歌, 找歌, 搜歌, 播放歌曲, 播放音乐, 放一首歌, 歌曲, 点歌, 热门歌曲, 热门音乐, 音乐, 音乐搜索, 音乐播放 for \"Popular Music Playback\". Price is USD 0.001 per policy music-playback-micro."}],"payment":{"paymentHeader":"X-Payment-Token","createPayment":"/api/payments","verifyPayment":"/api/payments/{paymentId}","token":{"header":"X-Payment-Token","mcpArgument":"paymentToken","httpUsage":"Send the paid token in the X-Payment-Token request header when calling /api/tools/*.","mcpUsage":"Pass the paid token as the paymentToken argument when calling the MCP tool."},"requiredResponse":{"status":402,"contentType":"application/json","headers":{"PAYMENT-REQUIRED":"base64/json x402PaymentRequired","PAYMENT-SIGNATURE":"base64/json x402 Base USDC payment payload","X-Payment-Required":"true","X-Payment-Token":"payment.token","X402-Guarantee":"base64url/json Xiao Coin escrow guarantee"},"bodySchema":{"properties":{"accepts":{"items":{"type":"object"},"type":"array"},"error":{"type":"string"},"extensions":{"type":"object"},"payment":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"},"paymentFlow":{"type":"object"},"resource":{"type":"object"},"retry":{"type":"object"},"type":{"const":"payment_required","type":"string"},"x402Version":{"type":"integer"}},"required":["type","error","payment","paymentFlow","retry"],"type":"object"},"x402Version":2,"x402Header":"PAYMENT-REQUIRED","paymentAsset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","paymentNetwork":"eip155:8453"},"retry":{"when":"Retry after paying one accepts[] requirement with Base USDC x402, Xiao Coin AI wallet escrow, or after payment.status is paid and the legacy token has remaining calls.","http":["Preferred x402 flow: call the paid /api/tools/* endpoint once and read accepts[] from the HTTP 402 response body or PAYMENT-REQUIRED header.","Pay one accepts[] requirement with an x402-compatible wallet/facilitator on network eip155:8453 using Base USDC.","Retry the exact same request with PAYMENT-SIGNATURE set to the base64 JSON x402 payment payload.","XIAO flow: pay the accepts[] requirement where asset=XIAO with the AI wallet, then retry the exact same request with X402-Guarantee set to the base64url guarantee JSON.","Legacy token flow: POST /api/payments with serviceId, complete/verify payment, then retry with X-Payment-Token set to payment.token."],"mcp":["Call the tool without paymentToken to receive payment_required structuredContent.","Preferred x402 clients should pay the accepts[] requirement and call the underlying HTTP endpoint with PAYMENT-SIGNATURE.","XIAO-capable agents should pay the XIAO accepts[] requirement through the AI wallet and call the underlying HTTP endpoint with X402-Guarantee.","Legacy MCP clients can complete or verify payment.paymentId, then call the same MCP tool again with paymentToken set to payment.token."],"examples":{"http402":["curl -i https://example.com/api/tools/timestamp","Read accepts[0].network=eip155:8453, accepts[0].asset=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, accepts[0].amount, and accepts[0].payTo.","curl -H 'PAYMENT-SIGNATURE: \u003cbase64-json-x402-payment-payload\u003e' https://example.com/api/tools/timestamp"],"legacyToken":["curl -X POST https://example.com/api/payments -H 'Content-Type: application/json' -d '{\"serviceId\":\"timestamp\"}'","curl -H 'X-Payment-Token: \u003cpayment.token\u003e' https://example.com/api/tools/timestamp"],"mcp":["Call tool timestamp with no paymentToken.","After payment is complete, call timestamp again with paymentToken=\u003cpayment.token\u003e."],"xiao":["curl -i https://example.com/api/tools/timestamp","Read the accepts[] entry with asset=XIAO, create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","curl -H 'X402-Guarantee: \u003cbase64url-guarantee-json\u003e' https://example.com/api/tools/timestamp"]},"failures":["payment required","payment token expired","payment token has no remaining calls","api key required","api key is not allowed to call this service"]},"flow":{"type":"http-402","createPayment":{"method":"POST","url":"/api/payments","bodySchema":{"properties":{"providerId":{"type":"string"},"serviceId":{"description":"Use the canonical service id from the catalog. Legacy internal ids remain accepted for backward compatibility.","type":"string"}},"required":["serviceId"],"type":"object"},"responseSchema":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"}},"verifyPayment":{"method":"GET","url":"/api/payments/{paymentId}","responseSchema":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"}},"token":{"header":"X-Payment-Token","mcpArgument":"paymentToken","httpUsage":"Send the paid token in the X-Payment-Token request header when calling /api/tools/*.","mcpUsage":"Pass the paid token as the paymentToken argument when calling the MCP tool."},"requiredResponse":{"status":402,"contentType":"application/json","headers":{"PAYMENT-REQUIRED":"base64/json x402PaymentRequired","PAYMENT-SIGNATURE":"base64/json x402 Base USDC payment payload","X-Payment-Required":"true","X-Payment-Token":"payment.token","X402-Guarantee":"base64url/json Xiao Coin escrow guarantee"},"bodySchema":{"properties":{"accepts":{"items":{"type":"object"},"type":"array"},"error":{"type":"string"},"extensions":{"type":"object"},"payment":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"},"paymentFlow":{"type":"object"},"resource":{"type":"object"},"retry":{"type":"object"},"type":{"const":"payment_required","type":"string"},"x402Version":{"type":"integer"}},"required":["type","error","payment","paymentFlow","retry"],"type":"object"},"x402Version":2,"x402Header":"PAYMENT-REQUIRED","paymentAsset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","paymentNetwork":"eip155:8453"},"retry":{"when":"Retry after paying one accepts[] requirement with Base USDC x402, Xiao Coin AI wallet escrow, or after payment.status is paid and the legacy token has remaining calls.","http":["Preferred x402 flow: call the paid /api/tools/* endpoint once and read accepts[] from the HTTP 402 response body or PAYMENT-REQUIRED header.","Pay one accepts[] requirement with an x402-compatible wallet/facilitator on network eip155:8453 using Base USDC.","Retry the exact same request with PAYMENT-SIGNATURE set to the base64 JSON x402 payment payload.","XIAO flow: pay the accepts[] requirement where asset=XIAO with the AI wallet, then retry the exact same request with X402-Guarantee set to the base64url guarantee JSON.","Legacy token flow: POST /api/payments with serviceId, complete/verify payment, then retry with X-Payment-Token set to payment.token."],"mcp":["Call the tool without paymentToken to receive payment_required structuredContent.","Preferred x402 clients should pay the accepts[] requirement and call the underlying HTTP endpoint with PAYMENT-SIGNATURE.","XIAO-capable agents should pay the XIAO accepts[] requirement through the AI wallet and call the underlying HTTP endpoint with X402-Guarantee.","Legacy MCP clients can complete or verify payment.paymentId, then call the same MCP tool again with paymentToken set to payment.token."],"examples":{"http402":["curl -i https://example.com/api/tools/timestamp","Read accepts[0].network=eip155:8453, accepts[0].asset=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, accepts[0].amount, and accepts[0].payTo.","curl -H 'PAYMENT-SIGNATURE: \u003cbase64-json-x402-payment-payload\u003e' https://example.com/api/tools/timestamp"],"legacyToken":["curl -X POST https://example.com/api/payments -H 'Content-Type: application/json' -d '{\"serviceId\":\"timestamp\"}'","curl -H 'X-Payment-Token: \u003cpayment.token\u003e' https://example.com/api/tools/timestamp"],"mcp":["Call tool timestamp with no paymentToken.","After payment is complete, call timestamp again with paymentToken=\u003cpayment.token\u003e."],"xiao":["curl -i https://example.com/api/tools/timestamp","Read the accepts[] entry with asset=XIAO, create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","curl -H 'X402-Guarantee: \u003cbase64url-guarantee-json\u003e' https://example.com/api/tools/timestamp"]},"failures":["payment required","payment token expired","payment token has no remaining calls","api key required","api key is not allowed to call this service"]}}}}