--- name: api.xona-agent.com description: api.xona-agent.com provides AI-generated intelligence across three domains: crypto market signals and token discovery (PumpFun/Solana and XLayer chains), X (Twitter) persona profiling, and image generation with trend-informed prompt refinement. It does not execute trades, stream live prices, or fetch raw social media data directly. host: api.xona-agent.com --- # api.xona-agent.com Xona Agent is a multi-capability AI inference host targeting autonomous agents that need structured, decision-ready outputs rather than raw data. It serves agents operating in crypto trading research, social media persona analysis, and AI image creation workflows. Its distinguishing characteristic is that every endpoint returns AI-synthesized, structured objects — signals, profiles, prompts, and images — rather than pass-through data from underlying sources. ## When to use this host Use this host when an agent needs AI-synthesized, structured outputs for crypto token research (PumpFun/Solana or XLayer only), X user persona profiling, or text-to-image generation with optional trend research. Do not use it for live streaming price feeds or real-time order books — use a dedicated market data API (e.g., CoinGecko, Binance) instead. Do not use it for trade execution or swap routing — use a DEX aggregator API instead. Do not use it for raw tweet fetching, follower counts, or engagement metrics — use the Twitter/X API or a social analytics platform instead. PumpFun and XLayer skills are chain-specific; do not expect cross-chain or non-PumpFun token data from those endpoints. Image generation is priced per call and is not suited for bulk batch workflows. ## Capabilities ### Crypto Market Intelligence Provides AI-generated trading signals and real-time token discovery across PumpFun/Solana and XLayer chains, giving agents structured sentiment scores, price targets, and trending token lists to inform trading or research decisions. - **`fetch-token-trading-signal`** — Returns an AI-generated market sentiment signal for a crypto ticker, including sentiment score, confidence, 7-day price target, risk level, key signals, and a one-line summary. - **`fetch-pumpfun-trending-tokens`** — Returns a list of trending PumpFun tokens with price change data, market caps, social links, AI-generated icon descriptions, an AI meta summary, and three fresh token launch ideas. - **`fetch-pumpfun-movers`** — Returns PumpFun top-moving tokens with price change data across 5m/1h/6h/24h windows, an AI-generated memecoin meta summary, and three AI-suggested token launch ideas. - **`discover-xlayer-hot-tokens`** — Returns a list of trending XLayer (chainIndex 196) tokens with price, market cap, liquidity, holder count, transaction stats, and inflow data. ### Social Persona Analysis Generates a structured personality and communication profile for any X (Twitter) user, covering tone, beliefs, writing style, and content patterns, based solely on their username. - **`generate-x-persona-profile`** — Generates a structured personality profile and persona insights for a given X (Twitter) username, including tone, core topics, beliefs, writing style, content patterns, and an avatar prompt. ### AI Image Generation Converts text prompts into high-quality CDN-hosted images using the FLUX.2 Pro model, with optional reference image guidance for style and composition. - **`generate-flux2-pro-image`** — Generates a high-quality image from a text prompt using the Black Forest Labs FLUX.2 Pro model, with optional aspect ratio and up to eight reference images for style or composition guidance. ### Trend-Informed Prompt Engineering Researches current X and Google trends to transform a rough image concept into a refined, generation-ready prompt plan with style variants, aspect ratio, lighting, and negative prompt recommendations. - **`refine-image-prompt-with-research`** — Searches X and Google for current trends, then transforms a raw image idea into an analyzed intent object, research snippets, and a refined generation-ready direction plan with prompt and metadata. ## Workflows ### Trend-Aware Image Creation *Use when an agent needs to generate a high-quality image from a rough concept and wants the output to reflect current visual or cultural trends rather than a naive prompt.* 1. **`refine-image-prompt-with-research`** — Convert the raw image idea into a trend-researched, optimized prompt plan with style variants, aspect ratio, and negative prompt guidance. 2. **`generate-flux2-pro-image`** — Pass the refined prompt and recommended aspect ratio from the previous step into FLUX.2 Pro to produce the final CDN-hosted image. ### PumpFun Meta Analysis and Signal Validation *Use when an agent needs to identify the hottest PumpFun memecoins and then validate a specific token's sentiment before making a trading recommendation.* 1. **`fetch-pumpfun-movers`** — Retrieve the fastest-moving PumpFun tokens with multi-window price change data and the AI-generated meta summary to identify candidate tokens. 2. **`fetch-token-trading-signal`** — For a specific ticker identified in the previous step, fetch a structured AI trading signal including sentiment score, confidence, 7-day price target, and risk flags. ### X Persona-Driven Avatar Creation *Use when an agent needs to generate a visual avatar or branded image for an X user based on their actual personality and communication style.* 1. **`generate-x-persona-profile`** — Analyze the X username to extract persona summary, tone, beliefs, and an avatar generation prompt. 2. **`refine-image-prompt-with-research`** — Feed the avatar prompt from the persona profile into the Creative Director AI to produce a trend-informed, generation-ready image direction plan. 3. **`generate-flux2-pro-image`** — Generate the final avatar image using the refined prompt and recommended metadata from the previous step. ## Skill reference ### `generate-x-persona-profile` **X Persona AI** — Generates a structured personality profile and persona insights for a given X (Twitter) username, including tone, core topics, beliefs, writing style, content patterns, and an avatar prompt. *Use when:* Use when an agent needs a detailed persona breakdown of an X user — including their communication style, recurring topics, beliefs, posting behavior, and avatar generation prompt — based solely on their X username. *Not for:* Do not use for real-time tweet fetching, follower analytics, or engagement metrics; use a social media analytics API instead. Not suitable for generating posts on behalf of a user. **Inputs:** - `x_username` (string, required) — The X (Twitter) username to analyze, including the @ symbol. **Returns:** Returns a persona object with summary, tone array, core topics, beliefs, a style profile with writing style and voice, content patterns with top formats and posting behavior, and an avatar object with a generation prompt and reference image URLs. **Example:** `{"x_username": "@elonmusk"}` --- ### `fetch-token-trading-signal` **Xona TokenSignal** — Returns an AI-generated market sentiment signal for a crypto ticker, including sentiment score, confidence, 7-day price target, risk level, key signals, and a one-line summary. *Use when:* Use when an agent needs a structured trading signal for a specific crypto token — including directional sentiment, confidence score, short-term price target, and risk flags — before making or recommending a trade decision. *Not for:* Do not use for real-time streaming price feeds or order execution; this is a single-shot sentiment analysis snapshot, not a live quote or trade instruction. **Inputs:** - `ticker` (string, required) — Token ticker symbol to analyze (e.g. SOL, BTC, ETH). **Returns:** Returns success=true with a data object containing sentiment label, sentiment_score, confidence, 7-day price target, 3 key signals, risk_level, risk_flags, a one-line summary, catalyst, grounding sources, and generated/expiry timestamps. **Example:** `{"ticker": "SOL"}` --- ### `generate-flux2-pro-image` **Flux 2 Pro Image Generation** — Generates a high-quality image from a text prompt using the Black Forest Labs FLUX.2 Pro model, with optional aspect ratio and up to eight reference images for style or composition guidance. *Use when:* Use when an agent needs to generate or edit a high-quality image from a detailed text prompt, optionally guided by reference images, and requires a CDN-hosted image URL in return. *Not for:* Do not use for real-time or streaming image previews, video generation, or image classification/analysis tasks. Not suitable for bulk batch generation workflows due to per-call fixed pricing. **Inputs:** - `prompt` (string, required) — Detailed text description of the image to generate. - `aspect_ratio` (string) — Desired image aspect ratio. Defaults to 1:1 if omitted. - `referenceImage` (array) — Array of reference image URLs (up to eight) used to guide style or composition of the generated image. **Returns:** Returns a CDN image_url, the echoed image_description prompt, and a metadata object containing model, aspect_ratio, reference_images, prompt_length, cdn_key, and replicate_url. **Example:** `{"prompt": "Create a cinematic, ultra-detailed fantasy city at sunset from a slightly elevated wide-angle perspective. The skyline features towering marble-and-bronze spires with glowing rune inlays.", "aspect_ratio": "16:9", "referenceImage": ["https://images.unsplash.com/photo-1501785888041-af3ef285b470?auto=format&fit=crop&w=1600&q=80"]}` --- ### `discover-xlayer-hot-tokens` **XLayer Token Discovery** — Returns a list of trending XLayer (chainIndex 196) tokens with price, market cap, liquidity, holder count, transaction stats, and inflow data. *Use when:* Use when an agent needs to discover hot or trending tokens on the XLayer chain, including their contract addresses, market cap, liquidity, price change, and trading activity metrics. *Not for:* Do not use for Solana-native token discovery or cross-chain token lookups; this endpoint returns only XLayer (chainIndex 196) token data. **Returns:** Returns success=true with chain='xlayer', action='hot_tokens', and a data array of trending XLayer tokens each containing symbol, contract address, price, market cap, liquidity, holder count, buy/sell tx counts, volume, and risk level. **Example:** `{"method":"POST","url":"https://api.xona-agent.com/token/xlayer-discovery","headers":{"Content-Type":"application/json"},"body":{}}` --- ### `fetch-pumpfun-trending-tokens` **PumpFun Pulse – Trending Tokens** — Returns a list of trending PumpFun tokens with price change data, market caps, social links, AI-generated icon descriptions, an AI meta summary, and three fresh token launch ideas. *Use when:* Use when an agent needs a real-time snapshot of trending PumpFun memecoins on Solana, including short-term price momentum, market cap, and an AI-synthesized read on the current memecoin meta. *Not for:* Do not use for historical token data, non-PumpFun tokens, or executing trades; use a swap or DEX API for order execution. **Returns:** Returns a count, an AI meta summary string, 3 token launch idea objects, and an array of trending PumpFun tokens each with price changes across 5m/1h/6h/24h, market cap, contract address, social links, and an AI icon description. **Example:** `GET https://api.xona-agent.com/token/pumpfun-trending` --- ### `fetch-pumpfun-movers` **PumpFun Movers Insights** — Returns PumpFun top-moving tokens with price change data across 5m/1h/6h/24h windows, an AI-generated memecoin meta summary, and three AI-suggested token launch ideas. *Use when:* Use when an agent needs a real-time snapshot of the fastest-moving PumpFun memecoins, including market cap, social links, icon descriptions, and an AI narrative of the current dominant meta to inform trading or token creation decisions. *Not for:* Do not use for historical price data, non-PumpFun tokens, or order execution; use a swap or charting API instead. **Inputs:** - `payment-signature` (string) — x402 payment signature obtained after submitting an on-chain USDC payment. Omit on first call to receive the 402 payment challenge. **Returns:** Returns count, an AI meta summary string, a suggestions array of 3 token ideas each with idea/reason/reference_ca, and a trending_tokens array with name, ticker, market cap, contract address, social links, icon URL, AI icon description, and 5m/1h/6h/24h price change percentages. **Example:** `GET https://api.xona-agent.com/token/pumpfun-movers` --- ### `refine-image-prompt-with-research` **Creative Director AI** — Searches X and Google for current trends, then transforms a raw image idea into an analyzed intent object, research snippets, and a refined generation-ready direction plan with prompt and metadata. *Use when:* Use when an agent needs to convert a rough image concept into an optimized, trend-informed generation prompt with style variants, aspect ratio, lighting guidance, and negative prompt recommendations before calling an image generation model. *Not for:* Do not use for directly generating images; this endpoint returns a prompt plan only. For actual image generation, pass the refined prompt to a dedicated image generation API. **Inputs:** - `idea` (string, required) — User's prompt or idea for image generation. Can include subject, style preferences, lighting, mood, and any specific technical requirements. - `reference_images` (array) — Array of existing image URLs to use as style or subject references. The API will carry these through into the generation direction. **Returns:** Returns an intent object with goal and audience, a research array of Google/X source snippets, and a direction array containing a refined generation prompt with aspect ratio, style tags, and reference images carried through. **Example:** `{"idea":"Ultra-detailed macro wildlife illustration of a yellow-and-black camponotus ant with cinematic studio lighting, shallow depth of field, subtle rim light, and a soft rainforest soil bokeh background. Provide 3 style variants: hyper-real macro, editorial illustration, cinematic 3D.","reference_images":["https://upload.wikimedia.org/wikipedia/commons/thumb/a/a7/Camponotus_flavomarginatus_ant.jpg/640px-Camponotus_flavomarginatus_ant.jpg"]}` ---