Syra — machine-readable API summary (llms.txt)
==============================================

Name: Syra
Tagline: Machine Money for Agents — pay-per-call crypto APIs (x402 USDC).

Base URL
--------
https://api.syraa.fun

Discovery (public, no API key)
------------------------------
GET /openapi.json              — OpenAPI 3.1 gateway catalog
GET /mpp-openapi.json          — MPP registry companion document
GET /.well-known/x402          — x402 resource catalog + payment instructions
GET /x402/capabilities         — live payment networks
GET /llms.txt                  — this file
GET /llms-full.txt             — full route / pricing reference
GET /skill.md                  — agent skill brief
GET /favicon.ico               — brand mark

How to pay
----------
Paid routes return HTTP 402 with Payment-Required + JSON `accepts`.
Settle the chosen offer, then retry with PAYMENT-SIGNATURE or X-PAYMENT.

Server accepts (see GET /x402/capabilities):
- Core USDC: Solana, Base
- Multi-chain USDC via PayAI when enabled
- Also when enabled: BSC B402, Algorand (GoPlausible), OKX X Layer (USDT0), Circle Gateway / Arc
- MCP/SDK auto-pay signers today: Solana (default), Base, Algorand

Send header `X-Syra-Channel: sdk|mcp|web|tg|lpbot|api` so usage is counted cleanly.
Send `X-Payer-Address` on the first unpaid hero call for one free sample per payer wallet (not per IP).
Optional `X-Syra-Partner: yourslug` is attribution only. No payouts.

Docs: https://docs.syraa.fun/docs/api/x402-api-standard

Start here (flagships, unique Syra data)
----------------------------------------
GET /signals/proven-wallets
curl -sS "https://api.syraa.fun/signals/proven-wallets" -H "X-Syra-Channel: sdk" -H "X-Payer-Address: YOUR_WALLET"
# 402 body includes schema + example. One free wallet sample, then $0.03.

GET /token/safety?mint=MINT
curl -sS "https://api.syraa.fun/token/safety?mint=So11111111111111111111111111111111111111112" -H "X-Syra-Channel: sdk" -H "X-Payer-Address: YOUR_WALLET"
# One SAFE/CAUTION/AVOID verdict. $0.01 after the free sample.

GET /digest/alpha?edition=yesterday
curl -sS "https://api.syraa.fun/digest/alpha?edition=yesterday" -H "X-Syra-Channel: sdk"
# Yesterday is free. Today's edition is $0.05. Losses are included.

Also heroes: /gmgn/token/dd, /gmgn/smart-money/radar, /gmgn/wallet/score, /defi/lp-scanner, /pumpfun/scout, /pumpfun/analyzer, /token/lifecycle, /token/lifecycle/radar, /narrative/radar, /brain?question=...

Commodity resale (Pyth, CoinGecko, DexScreener, GeckoTerminal, DefiLlama, Massive, OpenRouter chat) stays live but is listed after flagships in /.well-known/x402.

Passthrough leftovers (TopLedger, Nansen, Zerion, Dexter, Blocksize) are not in the public catalog.
GET / for JSON clients returns a catalog pointer, not a charge.
Public receipts (no wallet PII beyond short addresses): GET /public/receipts

Free onboarding
---------------
GET /free/pillars
GET /free/assets
GET /api/metrics
GET /public/receipts

MCP / SDK
---------
Agents: set up https://api.syraa.fun/skill.md
MCP (fund >= $1 Solana USDC first):
claude mcp add syra -e SYRA_API_BASE_URL=https://api.syraa.fun -e SYRA_PAYER_KEYPAIR=your-solana-secret -- npx -y @syra-ai/mcp-server@latest

Example MCP paid call after syra_consult:
syra_spend_proven_wallets
syra_spend_token_safety  (params.mint)
syra_spend_alpha_digest  (params.edition=yesterday|today)

SDK:
import { createSyraPaidClient } from "@syra-ai/sdk";
const syra = createSyraPaidClient({ baseUrl: "https://api.syraa.fun" });

Payer helper:
import { wrapFetchWithX402Payer } from "@syra-ai/x402-payer";

Refund coverage: @syra-ai/x402-refund — wrapFetchWithSyraRefund
Docs: https://docs.syraa.fun
Contact: support@syraa.fun