For builders & developers
Ship market intelligence in your agent, trading bot, dashboard, or backend — no API keys, pay-per-call via x402 USDC (Solana or Base). Machine-readable discovery via OpenAPI and MPP/AgentCash.
Base URL: https://conc-exe.xyz
Auth: None required. Optional X-Agent-Id: agt_… after agent registration.
Price: 0.10 USDC per call (100000 atomic) · publish signal 1.00 USDC
Choose your integration path
① Playground
Try any route, see 402 challenge, copy JSON bodies — fastest way to learn.
② OpenAPI
Full schemas, x-payment-info, MPP protocols — build any HTTP client.
③ AgentCash
npx agentcash add — install all skills into MPP-compatible agents.
④ pay.sh
pay curl — sandbox wallet, Claude/Codex MCP, no API keys.
⑤ Agent readiness
Audit rubric, api-catalog, idempotency, rate-limit headers — for agent integrators.
⑥ MCP Registry
Published xyz.conc-exe/concierge-intel — Cursor/Claude connect at /api/mcp.
x402 flow (all paid routes)
POSTwith JSON body → 402 +PAYMENT-REQUIREDheader (base64 requirements)- Sign USDC on Solana or Base — primary facilitator
facilitator.payai.network, fallbackx402.dexter.cash(Solana 402 lists both fee payers) - Retry same request with
PAYMENT-SIGNATUREheader - 200 → JSON response +
PAYMENT-RESPONSEsettlement header
Use an x402 HTTP client to automate steps 2–3. See Quickstart. For native SPL tokens, see Token Pay (Beta).
Token Pay (Beta)
Register your token so users pay with your SPL on supported x402 routes (default: POST /api/concierge).
- Add your row to
TOKEN_PAY_MERCHANTS_JSONin.env(local) or Vercel env (production) and redeploy - Ensure
payTohas an ATA; setfallbackUsdor DexScreener price - Verify
GET /api/token-pay?merchant=YOUR_ID→readiness.acceptReady: true - Wire x402 client: select accept with
extra.merchantId+extra.settlement: "self" - Monitor on /agent/token-pay
Fifteen endpoints — pick by use case
| Segment | Path | When to use |
|---|---|---|
| Chat | POST /api/concierge | Natural language — trading plans, macro, geo, DeFi Q&A (HTML reply) |
| Research | POST /api/concierge-intel-macro | SPX, VIX, DXY, Fear & Greed, Treasury yields — Poncho / agents |
| Research | POST /api/concierge-intel-wire | Wire headline digest — category or message filter |
| DeFi Intel | POST /api/concierge-intel-tvl | Chain + protocol TVL snapshot |
| DeFi Intel | POST /api/concierge-intel-yields | Screened yield pools (Meteora DLMM, Jupiter, …) |
| DeFi Intel | POST /api/concierge-intel-whales | BTC/ETH/SOL top-trader positioning |
| DeFi Intel | POST /api/concierge-intel-wallet | Solana/EVM wallet snapshot |
| DeFi Intel | POST /api/concierge-intel-verdict | Desk verdict + Lounge insider overlay |
| Alpha | POST /api/concierge-intel-airdrop | Potential airdrops — insider-first synthesis |
| Alpha | POST /api/concierge-intel-listing | Potential exchange listings |
| Alpha | POST /api/concierge-intel-momentum | Large-move candidates (up or down) |
| Alpha | POST /api/concierge-intel-scalp | BTC/ETH/BNB/SOL scalp desk (5m/15m) |
| Lounge | POST /api/news-open | Unlock wire article URL |
| Lounge | POST /api/lounge-signal-publish | Publish creator signal ($1) |
| Lounge | POST /api/lounge-signal-open | Unlock creator signal summary |
Structured JSON → Research + Intel + Alpha routes. HTML narrative → Concierge chat. Agent marketplaces: Poncho · x402scan. Details: Intel APIs · Concierge Chat
Example — probe Alpha Intel (curl)
# 1) Payment challenge
curl -s -X POST "https://conc-exe.xyz/api/concierge-intel-momentum" \
-H "Content-Type: application/json" \
-d '{"message":"BTC altcoin volatility","limit":5,"includeInsider":true}' \
-D - -o /dev/null | head -15
# 2) After x402 client pays — same body + PAYMENT-SIGNATURE header → 200 JSON
Alpha body fields: message, optional chain, limit (1–8), includeInsider (default true).
Example — TypeScript (server-side)
Call from your backend or agent worker (recommended — avoids browser CORS). Use your x402 SDK of choice; pseudocode:
const origin = "https://conc-exe.xyz";
const body = { chain: "solana", project: "meteora" };
// x402Client wraps: POST → 402 → sign → retry
const res = await x402Client.fetch(`${origin}/api/concierge-intel-yields`, {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-Agent-Id": "agt_your_agent_id", // optional
},
body: JSON.stringify(body),
});
const data = await res.json(); // { ok, pools, dataAsOf, ... }
Example — Python (httpx + x402)
import httpx
ORIGIN = "https://conc-exe.xyz"
payload = {"message": "Solana airdrop themes", "limit": 5}
# Use PayAI / x402 Python helper for payment round-trip
r = httpx.post(f"{ORIGIN}/api/concierge-intel-airdrop", json=payload)
# First response: 402 — decode PAYMENT-REQUIRED, settle, retry with PAYMENT-SIGNATURE
See Quickstart and repository docs/agents.md.
Discovery resources
| URL | Use |
|---|---|
GET /openapi.json | OpenAPI 3.1 + x402/MPP payment metadata per route |
GET /api/mcp | JSON-RPC MCP — tools/list, tools/call |
| MCP Registry | Official listing xyz.conc-exe/concierge-intel v1.0.1 — guide |
GET /skills/concierge-intel/SKILL.md | Agent Skills file for Claude/Cursor/Grok sessions |
GET /.well-known/api-catalog | RFC 9727 linkset — OpenAPI, MCP, x402, agent card |
GET /.well-known/x402 | Resource fan-out for x402scan / registries |
GET /api/x402-config | Networks, pricing flags (no secrets) |
GET /.well-known/agent-card.json | Concierge registry + agt_ cards |
npx agentcash add https://conc-exe.xyz
npx -y @agentcash/discovery@latest discover https://conc-exe.xyz
# pay.sh — CLI handles 402 automatically
pay --sandbox curl https://conc-exe.xyz/api/concierge-intel-verdict \
-d '{"message":"Solana DeFi outlook","includeInsider":true}'
See pay.sh · MPP & AgentCash
CORS & production tips
- Server-side proxy — Browsers on foreign origins may hit CORS; agents should call Concierge from a backend.
- Idempotency — Each paid call is independent; cache Intel JSON by
dataAsOfif you poll. - Insider layer — Alpha + verdict routes weight Lounge creator signals; publish signals to improve alpha quality.
- Distribution — Optional proxy via Corbits Marketplace, list on MPPscan, MCP Registry, or pay.sh pay-skills catalog.
Concierge Agent · Executive Lounge