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.
⑥ B2B case study
Procurement checklist, accuracy trust signal, example desk workflow — no API keys.
⑦ MCP Registry
Published xyz.conc-exe/concierge-intel — Cursor/Claude connect at /api/mcp.
⑧ Agent SDK
@conc-exe/agent — discover, settle x402/TCX, call intel desks.
⑧ Security Desk
Passive website scan ($0.10), scout audits ($0.02), free conc-exe.xyz self-audit — Lounge UI.
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
24 paid routes — 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-meteora | Meteora DLMM pool intelligence |
| 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 |
| Bundle | POST /api/concierge-intel-desk-brief | Multi-desk brief ($0.25) |
| Bundle | POST /api/concierge-intel-a2a-pipeline | A2A orchestration + delegate routing ($0.25) |
| 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) |
| Security | POST /api/concierge-security-scan | Unified posture breakdown ($0.10) · Lounge UI |
| Security | POST /api/concierge-security-readiness | Scout — API readiness ($0.02) |
| Security | POST /api/concierge-security-headers | Scout — HTTP security headers ($0.02) |
| Lounge | POST /api/news-open | Unlock wire article URL |
| Lounge | POST /api/lounge-signal-publish | Publish creator signal ($1) |
| Resources | POST /api/resource-chat | Agent-friendly one-turn chat ($0.05) — USDC, TCX, or credits |
| Resources | POST /api/resource-image | Image generation from prompt — base64 data URLs ($0.10) |
| Resources | POST /api/resource-scaffold | Single-file HTML scaffold from brief ($0.10) |
| Lounge | POST /api/lounge-signal-open | Unlock creator signal summary |
Free: POST /api/concierge-security-scope · POST /api/concierge-security-scan with selfAudit: true on conc-exe.xyz. Structured JSON → Research + Intel + Alpha + Security routes. HTML narrative → Concierge chat. Agent marketplaces: Poncho · x402scan. Details: Intel APIs · Security Desk · 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.1.0 — guide |
| Agent SDK | @conc-exe/agent — discover → pay → call intel/security from TypeScript |
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/resources | Concierge Resources catalog (chat, image, scaffold) |
GET /api/tcx-credits | TCX prepaid credit balance for Resources |
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 — Verified on MPPscan and MCP Registry; pay.sh remains pending PR #119. Corbits Marketplace is an optional proxy.
Concierge Agent · Executive Lounge