{"openapi":"3.1.0","info":{"title":"Xona Agent API","version":"1.0.0","description":"The Creative Resource Layer for the Agent Economy. Xona provides autonomous, pay-as-you-go infrastructure for image generation, music generation, text-to-speech, social media deep research and token branding kit. Payments via MPP (Machine Payments Protocol) on Tempo.","guidance":"# MPP Discovery Guidance\n\n1. Call a protected `/mpp/*` endpoint without `Authorization: Payment ...`.\n2. Receive HTTP 402 with `WWW-Authenticate: Payment ...`.\n3. Retry same request with `Authorization: Payment ...`.\n4. On success, receive HTTP 200 and `Payment-Receipt` header."},"x-service-info":{"categories":["ai","generation","research","blockchain"],"docs":{"homepage":"https://api.xona-agent.com","apiReference":"https://api.xona-agent.com/openapi.json"}},"x-discovery":{"ownershipProofs":["0x5af113143e64b76758d33a01e695fff3ef55028c1ce13da7bd47bff845c997213d0bfe5e1fd73d4aa6b1a6ee9050dd210f6bea8da7e56fbecbd863838cd350c11b"]},"servers":[{"url":"https://api.xona-agent.com","description":"Production server"},{"url":"http://localhost:8000","description":"Development server"}],"tags":[{"name":"Image Generation","description":"AI image generation endpoints"},{"name":"Image Models","description":"Direct image model endpoints"},{"name":"Video Generation","description":"AI video generation endpoints"},{"name":"Token Tools","description":"Token analysis and generation tools"},{"name":"Audio","description":"Music generation and text-to-speech endpoints"},{"name":"AI Services","description":"AI-powered services"}],"paths":{"/mpp/image/creative-director":{"post":{"tags":["Image Generation"],"summary":"AI-powered creative research and prompt refinement using X and Google","description":"AI-powered creative research and prompt refinement using X and Google. Analyzes trends, and transforms your idea into an optimized generation plan.","operationId":"mpp_image_creative_director","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.030000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"idea":{"type":"string","description":"User's prompt/idea for image generation"},"reference_images":{"type":"array","description":"Array of existing image URLs to use as references","items":{"type":"string"}}},"required":["idea"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"intent":{"type":"object","description":"Analyzed user intent from the prompt"},"research":{"type":"array","description":"Research results from X and Google","items":{"type":"object"}},"direction":{"type":"array","description":"Generation plan with refined prompt","items":{"type":"object"}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/image/designer":{"post":{"tags":["Image Generation"],"summary":"AI image generation with intelligent style blending","description":"AI image generation with intelligent style blending. Takes your prompt and style keywords, refines them together, and generates a high-quality image.","operationId":"mpp_image_designer","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.080000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"The detailed prompt description for image generation"},"style":{"type":"array","description":"Style keywords to blend into the prompt","items":{"type":"string"}},"aspect_ratio":{"type":"string","description":"Aspect ratio for the generated image (default: 1:1)"},"referenceImage":{"type":"array","description":"Array of reference image URLs for style guidance","items":{"type":"string"}}},"required":["prompt"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"image_url":{"type":"string","description":"The generated image URL (CDN)"},"image_description":{"type":"string","description":"The refined prompt used for generation"},"metadata":{"type":"object","description":"Generation metadata including model info, parameters, etc."}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/image/nano-banana-pro":{"post":{"tags":["Image Generation"],"summary":"AI image generation using nano-banana-pro model","description":"AI image generation using nano-banana-pro model. Takes your prompt and generates a high-quality image directly without style blending.","operationId":"mpp_image_nano_banana_pro","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.200000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"The detailed prompt description for image generation"},"aspect_ratio":{"type":"string","description":"Aspect ratio for the generated image (default: 1:1)"},"referenceImage":{"type":"array","description":"Array of reference image URLs for style guidance","items":{"type":"string"}}},"required":["prompt"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"image_url":{"type":"string","description":"The generated image URL (CDN)"},"image_description":{"type":"string","description":"The prompt used for generation"},"metadata":{"type":"object","description":"Generation metadata including model info, parameters, etc."}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/image/nano-banana":{"post":{"tags":["Image Generation"],"summary":"AI image generation using nano-banana model","description":"AI image generation using nano-banana model. Takes your prompt and generates a high-quality image directly without style blending.","operationId":"mpp_image_nano_banana","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.100000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"The detailed prompt description for image generation"},"aspect_ratio":{"type":"string","description":"Aspect ratio for the generated image (default: 1:1)"},"referenceImage":{"type":"array","description":"Array of reference image URLs for style guidance","items":{"type":"string"}}},"required":["prompt"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"image_url":{"type":"string","description":"The generated image URL (CDN)"},"image_description":{"type":"string","description":"The prompt used for generation"},"metadata":{"type":"object","description":"Generation metadata including model info, parameters, etc."}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/image/nano-banana-2":{"post":{"tags":["Image Generation"],"summary":"AI image generation using nano-banana-2 model with resolution-based pricing","description":"AI image generation using nano-banana-2 model with resolution-based pricing. Dynamic pricing: 1K=$0.06, 2K=$0.10, 4K=$0.15.","operationId":"mpp_image_nano_banana_2","x-payment-info":{"protocols":["mpp"],"pricingMode":"quote"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"The detailed prompt description for image generation"},"resolution":{"type":"string","description":"Output resolution. Options: 1k (1024px, $0.06), 2k (2048px, $0.10), 4k (4096px, $0.15). Default: 1k"},"aspect_ratio":{"type":"string","description":"Aspect ratio for the generated image (default: 1:1)"},"referenceImage":{"type":"array","description":"Array of reference image URLs for style guidance","items":{"type":"string"}}},"required":["prompt"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"image_url":{"type":"string","description":"The generated image URL (CDN)"},"image_description":{"type":"string","description":"The prompt used for generation"},"metadata":{"type":"object","description":"Generation metadata including model info, resolution, parameters, etc."}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/image/grok-imagine":{"post":{"tags":["Image Generation"],"summary":"AI image generation using Grok Imagine model","description":"AI image generation using Grok Imagine model. Takes your prompt and generates a high-quality image using xAI's Grok Imagine API.","operationId":"mpp_image_grok_imagine","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.040000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"The detailed prompt description for image generation"},"referenceImage":{"type":"string","description":"Single reference image URL for style guidance (Grok only supports one image)"}},"required":["prompt"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"image_url":{"type":"string","description":"The generated image URL (CDN)"},"image_description":{"type":"string","description":"The prompt used for generation"},"metadata":{"type":"object","description":"Generation metadata including model info, parameters, etc."}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/video/short-generation":{"post":{"tags":["Video Generation"],"summary":"AI short video generation using Grok Imagine Video model","description":"AI short video generation using Grok Imagine Video model. Takes your prompt and generates a 10-second high-quality video using xAI's Grok Video API.","operationId":"mpp_video_short_generation","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.500000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"Prompt for video generation"},"aspect_ratio":{"type":"string","description":"Video aspect ratio"},"image_url":{"type":"string","description":"Optional input image URL for image-to-video generation"}},"required":["prompt"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"video_url":{"type":"string","description":"The generated video URL"},"duration":{"type":"number","description":"Video duration in seconds (always 10)"},"model":{"type":"string","description":"Model used for generation"},"metadata":{"type":"object","description":"Generation metadata including request_id, aspect_ratio, etc."}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/audio/elevenlabs-music":{"post":{"tags":["Audio"],"summary":"AI music generation using ElevenLabs Music (Replicate)","description":"AI music generation using ElevenLabs Music (Replicate). Dynamic pricing: $1 per 120 seconds, max 3 minutes ($1.50).","operationId":"mpp_audio_elevenlabs_music","x-payment-info":{"protocols":["mpp"],"pricingMode":"quote"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"Description of the music to generate"},"output_format":{"type":"string","description":"Output format (e.g. mp3_standard)"},"music_length_ms":{"type":"number","description":"Duration in milliseconds (min 1000, max 180000). Price = music_length_ms/120000 USD."},"force_instrumental":{"type":"boolean","description":"Force instrumental output"}},"required":["prompt"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"music_url":{"type":"string","description":"The generated audio URL (CDN)"},"duration_seconds":{"type":"number","description":"Duration in seconds"},"metadata":{"type":"object","description":"Generation metadata"}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/audio/speech-to-text":{"post":{"tags":["Audio"],"summary":"Speech-to-text: transcribe audio from a URL using OpenAI GPT-4o Transcribe (Replicate)","description":"Speech-to-text: transcribe audio from a URL using OpenAI GPT-4o Transcribe (Replicate).","operationId":"mpp_audio_speech_to_text","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.020000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"audio_file":{"type":"string","description":"HTTPS URL of the audio file to transcribe (e.g. MP3)"},"language":{"type":"string","description":"Language code (default: en)"}},"required":["audio_file"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"Transcribed text"},"metadata":{"type":"object","description":"Model and language metadata"}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/token/pumpfun-trending":{"get":{"tags":["Token Tools"],"summary":"Get trending PumpFun tokens with AI-powered analysis including dominant meta summary, fresh token suggestions, and detailed token information with price changes and icon descriptions","description":"Get trending PumpFun tokens with AI-powered analysis including dominant meta summary, fresh token suggestions, and detailed token information with price changes and icon descriptions","operationId":"mpp_token_pumpfun_trending","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.100000"},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"summary":{"type":"string","description":"AI-generated summary of dominant memecoin meta"},"suggestions":{"type":"array","description":"Array of 3 fresh token ideas","items":{"type":"object","properties":{"idea":{"type":"string","description":"Token name, ticker, and visual description"},"reference_ca":{"type":"string","description":"Contract address of referenced token"},"reason":{"type":"string","description":"Why it could pump"}}}},"trending_tokens":{"type":"array","description":"Array of trending tokens","items":{"type":"object","properties":{"icon":{"type":"string","description":"Token icon URL"},"name":{"type":"string","description":"Token name"},"ticker":{"type":"string","description":"Token ticker symbol"},"mc":{"type":"string","description":"Market cap (formatted)"},"ca":{"type":"string","description":"Contract address"},"social":{"type":"object","properties":{"twitter":{"type":"string","description":"Twitter URL"},"website":{"type":"string","description":"Website URL"}}},"5mpricechange":{"type":"number","description":"5 minute price change percentage"},"1hpricechange":{"type":"number","description":"1 hour price change percentage"},"6hpricechange":{"type":"number","description":"6 hour price change percentage"},"24hpricechange":{"type":"number","description":"24 hour price change percentage"},"icon_description":{"type":"string","description":"AI-generated description of the token icon"}}}},"count":{"type":"number","description":"Number of trending tokens returned"}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/token/pumpfun-movers":{"get":{"tags":["Token Tools"],"summary":"Get movers PumpFun tokens with AI-powered analysis including dominant meta summary, fresh token suggestions, and detailed token information with price changes and icon descriptions","description":"Get movers PumpFun tokens with AI-powered analysis including dominant meta summary, fresh token suggestions, and detailed token information with price changes and icon descriptions","operationId":"mpp_token_pumpfun_movers","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.100000"},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"summary":{"type":"string","description":"AI-generated summary of dominant memecoin meta"},"suggestions":{"type":"array","description":"Array of 3 fresh token ideas","items":{"type":"object","properties":{"idea":{"type":"string","description":"Token name, ticker, and visual description"},"reference_ca":{"type":"string","description":"Contract address of referenced token"},"reason":{"type":"string","description":"Why it could pump"}}}},"trending_tokens":{"type":"array","description":"Array of movers tokens","items":{"type":"object","properties":{"icon":{"type":"string","description":"Token icon URL"},"name":{"type":"string","description":"Token name"},"ticker":{"type":"string","description":"Token ticker symbol"},"mc":{"type":"string","description":"Market cap (formatted)"},"ca":{"type":"string","description":"Contract address"},"social":{"type":"object","properties":{"twitter":{"type":"string","description":"Twitter URL"},"website":{"type":"string","description":"Website URL"}}},"5mpricechange":{"type":"number","description":"5 minute price change percentage"},"1hpricechange":{"type":"number","description":"1 hour price change percentage"},"6hpricechange":{"type":"number","description":"6 hour price change percentage"},"24hpricechange":{"type":"number","description":"24 hour price change percentage"},"icon_description":{"type":"string","description":"AI-generated description of the token icon"}}}},"count":{"type":"number","description":"Number of movers tokens returned"}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/token/news":{"post":{"tags":["Token Tools"],"summary":"Fetch token information from Jupiter via Corbits, get curated news from Syra, and generate banner and social content with Xona","description":"Fetch token information from Jupiter via Corbits, get curated news from Syra, and generate banner and social content with Xona.","operationId":"mpp_token_news","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.500000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","description":"Token mint address, symbol, or name"}},"required":["token"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the operation was successful"},"mint":{"type":"string","description":"Token mint address from Jupiter"},"token":{"type":"string","description":"Token name from Jupiter"},"ticker":{"type":"string","description":"Token symbol from Jupiter"},"trending_news":{"type":"object","description":"AI-generated news content","properties":{"title":{"type":"string","description":"AI-generated news title (max 4 words)"},"tweet_draft":{"type":"string","description":"AI-generated tweet draft"},"banner_url":{"type":"string","description":"AI-generated news banner URL (CDN)"}}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/token/starter-kit":{"post":{"tags":["Token Tools"],"summary":"Generate token logo and banner automatically from a prompt","description":"Generate token logo and banner automatically from a prompt. Extracts token information, generates logo, then creates a matching banner.","operationId":"mpp_token_starter_kit","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.200000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"Description of the token"},"ca_reference":{"type":"string","description":"Contract address of reference token to extract logo from"}},"required":["prompt"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"token_name":{"type":"string","description":"The token name"},"token_ticker":{"type":"string","description":"The token ticker symbol (uppercase)"},"token_description":{"type":"string","description":"Comprehensive token description"},"logo_url":{"type":"string","description":"URL of the generated logo (CDN)"},"banner_url":{"type":"string","description":"URL of the generated banner (CDN)"}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/token/signal":{"post":{"tags":["Token Tools"],"summary":"AI-powered market sentiment analysis for a crypto ticker — sentiment score, price target, key signals, risk level, and a one-line summary","description":"AI-powered market sentiment analysis for a crypto ticker — sentiment score, price target, key signals, risk level, and a one-line summary.","operationId":"mpp_token_signal","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.020000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string","description":"Token ticker symbol (e.g. SOL, BTC, ETH)"}},"required":["ticker"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the operation succeeded"},"data":{"type":"object","description":"Sentiment analysis payload","properties":{"signal_id":{"type":"string","description":"Unique signal identifier"},"ticker":{"type":"string","description":"Uppercase ticker symbol"},"asset_name":{"type":"string","description":"Full name of the asset"},"current_price":{"type":"string","description":"Current price with $ sign, e.g. \"$145.23\""},"sentiment":{"type":"string","enum":["very_bullish","bullish","neutral","bearish","very_bearish"]},"sentiment_score":{"type":"number","description":"Float between -1 (bearish) and 1 (bullish)"},"confidence":{"type":"number","description":"Float between 0 and 1"},"price_target":{"type":"object","properties":{"7d_target":{"type":"string","description":"Price target within 7 days, e.g. \"$165\""},"direction":{"type":"string","enum":["up","down","sideways"]},"change_pct":{"type":"string","description":"Percentage change, e.g. \"+13.6%\""}}},"signals":{"type":"array","items":{"type":"string"},"description":"Exactly 3 key market signals"},"risk_level":{"type":"string","enum":["low","medium","high"]},"risk_flags":{"type":"array","items":{"type":"string"},"description":"0-3 risk labels"},"summary":{"type":"string","description":"One concise sentence with price target and timeframe"},"catalyst":{"type":"string","description":"Primary driver phrase"},"sources":{"type":"array","items":{"type":"string"},"description":"Source URLs from search"},"generated_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"}}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/token/solana-discovery":{"post":{"tags":["Token Tools"],"summary":"Solana token discovery via Onchain OS — hot tokens, top movers, search, smart money signals, top traders","description":"Solana token discovery via Onchain OS — hot tokens, top movers, search, smart money signals, top traders.","operationId":"mpp_token_solana_discovery","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.010000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","description":"hot_tokens (default), top_movers, search, smart_money, or top_traders"},"keyword":{"type":"string","description":"Required when action is search"},"limit":{"type":"number","description":"Max results (default 20)"},"timeFrame":{"type":"string","description":"Time frame code (default 4)"},"sortBy":{"type":"string","description":"Sort for top_movers or top_traders"},"tokenAddress":{"type":"string","description":"Optional mint for smart_money"},"walletType":{"type":"string","description":"Wallet type for smart_money (default 1)"}},"required":[]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request succeeded"},"chain":{"type":"string","description":"solana"},"action":{"type":"string","description":"Action performed"},"data":{"type":"object","description":"Discovery data from Onchain OS"}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/token/solana-market":{"post":{"tags":["Token Tools"],"summary":"Solana token market data via Onchain OS — overview, risk, holders, candlesticks, whale trades, cluster check","description":"Solana token market data via Onchain OS — overview, risk, holders, candlesticks, whale trades, cluster check.","operationId":"mpp_token_solana_market","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.010000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","description":"token_overview, token_risk, holder_analysis, candlesticks, whale_trades, or cluster_check"},"tokenAddress":{"type":"string","description":"Solana mint address (required for most actions)"},"tokenAddresses":{"type":"array","description":"Multiple mints for token_overview","items":{"type":"string"}},"bar":{"type":"string","description":"Candle interval for candlesticks (default 1H)"},"limit":{"type":"number","description":"Limit for candles/trades (default 50)"},"tagFilter":{"type":"string","description":"Optional filter for whale_trades / holders"}},"required":["action"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request succeeded"},"chain":{"type":"string","description":"solana"},"action":{"type":"string","description":"Action performed"},"data":{"type":"object","description":"Market data from Onchain OS"}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/ai/x-persona":{"post":{"tags":["AI Services"],"summary":"Extract structured persona from X (Twitter) username","description":"Extract structured persona from X (Twitter) username. Analyzes posts, profile, and communication style to generate persona, style profile, content patterns, and avatar prompt.","operationId":"mpp_ai_x_persona","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.050000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"x_username":{"type":"string","description":"X (Twitter) username (with or without @)"}},"required":["x_username"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"persona":{"type":"object","description":"Persona information including summary, tone, core topics, and beliefs"},"style_profile":{"type":"object","description":"Writing style and voice characteristics"},"content_patterns":{"type":"object","description":"Content patterns and posting behavior analysis"},"avatar":{"type":"object","description":"Avatar information including image type, prompt, and reference images"}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/ai/x-news":{"post":{"tags":["AI Services"],"summary":"Extract latest news from X (Twitter) username, generate draft tweet and banner with Xona","description":"Extract latest news from X (Twitter) username, generate draft tweet and banner with Xona.","operationId":"mpp_ai_x_news","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.500000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"x_username":{"type":"string","description":"X (Twitter) username (with or without @)"},"x_persona":{"type":"string","description":"X (Twitter) username to mimic persona/style for tweet draft (optional)"}},"required":["x_username"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the operation was successful"},"x_username":{"type":"string","description":"The X username"},"trending_news":{"type":"object","description":"AI-generated news content","properties":{"title":{"type":"string","description":"AI-generated news title (max 4 words)"},"tweet_draft":{"type":"string","description":"AI-generated tweet draft"},"banner_url":{"type":"string","description":"AI-generated news banner URL (CDN)"}}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/image/flux-2-pro":{"post":{"tags":["Image Generation"],"summary":"High-quality image generation and editing with support for eight reference images","description":"High-quality image generation and editing with support for eight reference images","operationId":"mpp_image_flux_2_pro","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.060000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"Text prompt for image generation"},"resolution":{"type":"string","description":"Output resolution label, e.g. \"1 MP\""},"aspect_ratio":{"type":"string","description":"Aspect ratio, e.g. \"1:1\"; use \"custom\" with width and height"},"input_images":{"type":"array","description":"HTTPS URLs of reference images (limits vary by model)","items":{"type":"string"}},"output_format":{"type":"string","description":"webp, png, or jpg"},"output_quality":{"type":"number","description":"Encoder quality 0–100"},"safety_tolerance":{"type":"number","description":"Safety tolerance 1 (strict) to 5 (permissive); default 2"},"seed":{"type":"number","description":"Optional seed for reproducible generation"},"width":{"type":"number","description":"Width when aspect_ratio is custom (multiple of 16)"},"height":{"type":"number","description":"Height when aspect_ratio is custom (multiple of 16)"}},"required":["prompt"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"image_url":{"type":"string","description":"Generated image URL (CDN)"},"image_description":{"type":"string","description":"Prompt used"},"metadata":{"type":"object","description":"Model, parameters, CDN key, upstream image URL","properties":{"model":{"type":"string"},"resolution":{"type":"string"},"aspect_ratio":{"type":"string"},"output_format":{"type":"string"},"replicate_url":{"type":"string"}}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/image/flux-2-max":{"post":{"tags":["Image Generation"],"summary":"The highest fidelity image model from Black Forest Labs","description":"The highest fidelity image model from Black Forest Labs","operationId":"mpp_image_flux_2_max","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.100000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"Text prompt for image generation"},"resolution":{"type":"string","description":"Output resolution label, e.g. \"1 MP\""},"aspect_ratio":{"type":"string","description":"Aspect ratio, e.g. \"1:1\"; use \"custom\" with width and height"},"input_images":{"type":"array","description":"HTTPS URLs of reference images (limits vary by model)","items":{"type":"string"}},"output_format":{"type":"string","description":"webp, png, or jpg"},"output_quality":{"type":"number","description":"Encoder quality 0–100"},"safety_tolerance":{"type":"number","description":"Safety tolerance 1 (strict) to 5 (permissive); default 2"},"seed":{"type":"number","description":"Optional seed for reproducible generation"},"width":{"type":"number","description":"Width when aspect_ratio is custom (multiple of 16)"},"height":{"type":"number","description":"Height when aspect_ratio is custom (multiple of 16)"}},"required":["prompt"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"image_url":{"type":"string","description":"Generated image URL (CDN)"},"image_description":{"type":"string","description":"Prompt used"},"metadata":{"type":"object","description":"Model, parameters, CDN key, upstream image URL","properties":{"model":{"type":"string"},"resolution":{"type":"string"},"aspect_ratio":{"type":"string"},"output_format":{"type":"string"},"replicate_url":{"type":"string"}}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/image/flux-2-flex":{"post":{"tags":["Image Generation"],"summary":"Max-quality image generation and editing with support for ten reference images","description":"Max-quality image generation and editing with support for ten reference images","operationId":"mpp_image_flux_2_flex","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.050000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"Text prompt for image generation"},"resolution":{"type":"string","description":"Output resolution label, e.g. \"1 MP\""},"aspect_ratio":{"type":"string","description":"Aspect ratio, e.g. \"1:1\"; use \"custom\" with width and height"},"input_images":{"type":"array","description":"HTTPS URLs of reference images (limits vary by model)","items":{"type":"string"}},"output_format":{"type":"string","description":"webp, png, or jpg"},"output_quality":{"type":"number","description":"Encoder quality 0–100"},"safety_tolerance":{"type":"number","description":"Safety tolerance 1 (strict) to 5 (permissive); default 2"},"seed":{"type":"number","description":"Optional seed for reproducible generation"},"width":{"type":"number","description":"Width when aspect_ratio is custom (multiple of 16)"},"height":{"type":"number","description":"Height when aspect_ratio is custom (multiple of 16)"}},"required":["prompt"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"image_url":{"type":"string","description":"Generated image URL (CDN)"},"image_description":{"type":"string","description":"Prompt used"},"metadata":{"type":"object","description":"Model, parameters, CDN key, upstream image URL","properties":{"model":{"type":"string"},"resolution":{"type":"string"},"aspect_ratio":{"type":"string"},"output_format":{"type":"string"},"replicate_url":{"type":"string"}}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/sol/token-signal":{"post":{"tags":["Token Tools"],"summary":"AI-powered market sentiment analysis for a crypto ticker — sentiment score, price target, key signals, risk level, and a one-line summary","description":"AI-powered market sentiment analysis for a crypto ticker — sentiment score, price target, key signals, risk level, and a one-line summary. Solana settlement (USDC) via Dexter MPP at /mpp/sol/token-signal.","operationId":"mpp_sol_token_signal","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.001000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string","description":"Token ticker symbol (e.g. SOL, BTC, ETH)"}},"required":["ticker"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the operation succeeded"},"data":{"type":"object","description":"Sentiment analysis payload","properties":{"signal_id":{"type":"string","description":"Unique signal identifier"},"ticker":{"type":"string","description":"Uppercase ticker symbol"},"asset_name":{"type":"string","description":"Full name of the asset"},"current_price":{"type":"string","description":"Current price with $ sign, e.g. \"$145.23\""},"sentiment":{"type":"string","enum":["very_bullish","bullish","neutral","bearish","very_bearish"]},"sentiment_score":{"type":"number","description":"Float between -1 (bearish) and 1 (bullish)"},"confidence":{"type":"number","description":"Float between 0 and 1"},"price_target":{"type":"object","properties":{"7d_target":{"type":"string","description":"Price target within 7 days, e.g. \"$165\""},"direction":{"type":"string","enum":["up","down","sideways"]},"change_pct":{"type":"string","description":"Percentage change, e.g. \"+13.6%\""}}},"signals":{"type":"array","items":{"type":"string"},"description":"Exactly 3 key market signals"},"risk_level":{"type":"string","enum":["low","medium","high"]},"risk_flags":{"type":"array","items":{"type":"string"},"description":"0-3 risk labels"},"summary":{"type":"string","description":"One concise sentence with price target and timeframe"},"catalyst":{"type":"string","description":"Primary driver phrase"},"sources":{"type":"array","items":{"type":"string"},"description":"Source URLs from search"},"generated_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"}}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mpp/stellar/token-signal":{"post":{"tags":["Token Tools"],"summary":"AI-powered market sentiment analysis for a crypto ticker — sentiment score, price target, key signals, risk level, and a one-line summary","description":"AI-powered market sentiment analysis for a crypto ticker — sentiment score, price target, key signals, risk level, and a one-line summary. Stellar settlement (USDC) via Soroban SAC MPP at /mpp/stellar/token-signal.","operationId":"mpp_stellar_token_signal","x-payment-info":{"protocols":["mpp"],"pricingMode":"fixed","price":"0.001000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string","description":"Token ticker symbol (e.g. SOL, BTC, ETH)"}},"required":["ticker"]}}}},"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"},"description":"MPP payment credential, typically `Payment <serialized-credential>`. Omit on first call to receive 402 challenge."}],"responses":{"200":{"description":"Successful response","headers":{"Payment-Receipt":{"description":"Serialized MPP payment receipt.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the operation succeeded"},"data":{"type":"object","description":"Sentiment analysis payload","properties":{"signal_id":{"type":"string","description":"Unique signal identifier"},"ticker":{"type":"string","description":"Uppercase ticker symbol"},"asset_name":{"type":"string","description":"Full name of the asset"},"current_price":{"type":"string","description":"Current price with $ sign, e.g. \"$145.23\""},"sentiment":{"type":"string","enum":["very_bullish","bullish","neutral","bearish","very_bearish"]},"sentiment_score":{"type":"number","description":"Float between -1 (bearish) and 1 (bullish)"},"confidence":{"type":"number","description":"Float between 0 and 1"},"price_target":{"type":"object","properties":{"7d_target":{"type":"string","description":"Price target within 7 days, e.g. \"$165\""},"direction":{"type":"string","enum":["up","down","sideways"]},"change_pct":{"type":"string","description":"Percentage change, e.g. \"+13.6%\""}}},"signals":{"type":"array","items":{"type":"string"},"description":"Exactly 3 key market signals"},"risk_level":{"type":"string","enum":["low","medium","high"]},"risk_flags":{"type":"array","items":{"type":"string"},"description":"0-3 risk labels"},"summary":{"type":"string","description":"One concise sentence with price target and timeframe"},"catalyst":{"type":"string","description":"Primary driver phrase"},"sources":{"type":"array","items":{"type":"string"},"description":"Source URLs from search"},"generated_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"}}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment Required","headers":{"WWW-Authenticate":{"description":"Payment challenge descriptor.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer","example":402},"detail":{"type":"string"},"challengeId":{"type":"string"}}}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"string","description":"Error code or type"},"message":{"type":"string","description":"Human-readable error message"}}}}}}