YunaraX402 Docs

Getting Started

Every Yunara account includes an on-chain wallet and access to the yunarax402 SDK. Follow these steps to begin:

Sign in with Google from the Yunara dashboard.
Connect your Phantom wallet for payments (Solana USDC).
Activate a subscription plan from Wallet → Subscription to credit Compute Units (CU). Plans: Starter ($20/100 CU), Trader ($40/200 CU), Pro ($100/500 CU) - all 60% OFF.
Generate an API key under Wallet → SDK API Keys. Copy and store it securely—the full key is shown once.
Send authenticated requests to https://yunarax402.com/api/sdk/analyze.

All SDK requests consume Compute Units. Each AI token analysis deducts 1 CU from your active plan. You can top-up your subscription by purchasing additional packages anytime during the month. All CUs reset at month end.

Authentication

Authenticate by sending your API key in the X-API-Key header (preferred) or via bearer token.

curl -X POST https://yunarax402.com/api/sdk/analyze \
  -H "Content-Type: application/json" \
  -H "X-API-Key: x402_XXXXXXXXXXXXXXXX" \
  -d '{ "tokenData": { "name": "Example", "symbol": "EXMPL", "address": "0x...", "chain": "base" } }'

Unauthorized requests return 401 invalid_api_key. If you exceed 60 requests per minute, the API responds with 429 rate_limited.

API Endpoints

Endpoint	Method	Description
`/api/sdk/analyze`	POST	Generates a full AI analysis for the provided token data. Response includes risk metrics, performance summary, and social insights.
`/api/subscriptions/status`	GET	Returns active plan details, remaining CU, renewal date, and recent usage history.
`/api/subscriptions/purchase`	POST	Initiates on-chain plan activation using x402 payments (Solana USDC via Phantom wallet). Supports top-up purchases. Called automatically from the dashboard.
`/api/ai-token-calls/current`	GET	Get current AI token recommendations from automated Pump.fun scans.
`/api/ai-token-calls/history`	GET	Get all-time leaderboard and performance metrics for AI token calls.
`/api/ai-chat`	POST	AI chat interface with Grok Twitter insights for PRO users. Supports free and PRO modes.

The tokenData payload accepts any metadata you already possess (symbol, launchpad, liquidity, etc.). Missing fields are auto-filled from Yunara's data sources when available. PRO users receive Grok Twitter insights automatically included in the analysis response.

{
  "tokenData": {
    "name": "Example Token",
    "symbol": "EXMPL",
    "address": "0x1234...abcd",
    "chain": "base",
    "marketCap": 1250000,
    "volume24h": 420000,
    "liquidity": 165000
  }
}

SDK Usage

Use the SDK from any environment that can issue HTTPS requests. Examples for Node.js and Python:

Node.js

import fetch from 'node-fetch';

const API_KEY = process.env.yunarax402_API_KEY;
const API_BASE = 'https://yunarax402.com';

export async function analyzeToken(token) {
  const res = await fetch(`${API_BASE}/api/sdk/analyze`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': API_KEY
    },
    body: JSON.stringify({ tokenData: token })
  });

  if (!res.ok) {
    const err = await res.json().catch(() => ({}));
    throw new Error(`Analysis failed (${res.status}): ${err.message || err.error}`);
  }

  return res.json();
}

Python

import requests

API_BASE = "https://yunarax402.com"
API_KEY = "x402_..."

payload = {"tokenData": {"name": "Example", "symbol": "EXMPL", "address": "0x...", "chain": "base"}}
headers = {"Content-Type": "application/json", "X-API-Key": API_KEY}

response = requests.post(f"{API_BASE}/api/sdk/analyze", json=payload, headers=headers, timeout=30)
response.raise_for_status()
data = response.json()

Automation & Webhooks

You can poll /api/sdk/analyze on a schedule or trigger it whenever a new token is detected in your pipeline. Recommended patterns:

Cron polling: Run analyses at fixed intervals and store JSON output in your analytics warehouse.
Event-driven: Combine with launchpad webhooks to automatically analyze new listings.
Discord/Slack alerts: Pipe significant AI insights directly to trading chats.

Webhook delivery of AI analyses is on the roadmap. Contact support to join the beta.

Compute Units

Compute Units (CU) meter usage across the ecosystem:

1 CU deducted per successful AI analysis.
Failed or rate-limited calls do not consume CU.
Top-Up Support: Purchase additional packages anytime during your subscription period to add CUs to your existing balance.
Monthly Reset: All CUs (including top-ups) expire at month end. If auto-renew is enabled, CUs reset to base plan allocation. If disabled, CUs reset to 0 and subscription becomes inactive.
Monitor remaining CU via /api/subscriptions/status or the Wallet dashboard.

Subscription Plans

Starter: 100 CU for $20/month (was $50 - 60% OFF)
Trader: 200 CU for $40/month (was $100 - 60% OFF)
Pro: 500 CU for $100/month (was $250 - 60% OFF)

All payments use x402 protocol on Solana with Phantom wallet integration.

Support & Resources

Need help integrating the SDK or interpreting results?

Email: support@yunara.ai
Discord: join #yunara-developers
Status page: status.yunarax402.com

We welcome feature requests and feedback—let us know how to improve your workflows.

YunaraX402

AI Alerts

YunaraX402 Developer Documentation