Integrate

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

x402 flow (all paid routes)

  1. POST with JSON body → 402 + PAYMENT-REQUIRED header (base64 requirements)
  2. Sign USDC on Solana or Base — primary facilitator facilitator.payai.network, fallback x402.dexter.cash (Solana 402 lists both fee payers)
  3. Retry same request with PAYMENT-SIGNATURE header
  4. 200 → JSON response + PAYMENT-RESPONSE settlement 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).

  1. Add your row to TOKEN_PAY_MERCHANTS_JSON in .env (local) or Vercel env (production) and redeploy
  2. Ensure payTo has an ATA; set fallbackUsd or DexScreener price
  3. Verify GET /api/token-pay?merchant=YOUR_IDreadiness.acceptReady: true
  4. Wire x402 client: select accept with extra.merchantId + extra.settlement: "self"
  5. Monitor on /agent/token-pay

Full Token Pay (Beta) integration guide →

24 paid routes — pick by use case

SegmentPathWhen to use
ChatPOST /api/conciergeNatural language — trading plans, macro, geo, DeFi Q&A (HTML reply)
ResearchPOST /api/concierge-intel-macroSPX, VIX, DXY, Fear & Greed, Treasury yields — Poncho / agents
ResearchPOST /api/concierge-intel-wireWire headline digest — category or message filter
DeFi IntelPOST /api/concierge-intel-tvlChain + protocol TVL snapshot
DeFi IntelPOST /api/concierge-intel-yieldsScreened yield pools (Meteora DLMM, Jupiter, …)
DeFi IntelPOST /api/concierge-intel-meteoraMeteora DLMM pool intelligence
DeFi IntelPOST /api/concierge-intel-whalesBTC/ETH/SOL top-trader positioning
DeFi IntelPOST /api/concierge-intel-walletSolana/EVM wallet snapshot
DeFi IntelPOST /api/concierge-intel-verdictDesk verdict + Lounge insider overlay
BundlePOST /api/concierge-intel-desk-briefMulti-desk brief ($0.25)
BundlePOST /api/concierge-intel-a2a-pipelineA2A orchestration + delegate routing ($0.25)
AlphaPOST /api/concierge-intel-airdropPotential airdrops — insider-first synthesis
AlphaPOST /api/concierge-intel-listingPotential exchange listings
AlphaPOST /api/concierge-intel-momentumLarge-move candidates (up or down)
AlphaPOST /api/concierge-intel-scalpBTC/ETH/BNB/SOL scalp desk (5m/15m)
SecurityPOST /api/concierge-security-scanUnified posture breakdown ($0.10) · Lounge UI
SecurityPOST /api/concierge-security-readinessScout — API readiness ($0.02)
SecurityPOST /api/concierge-security-headersScout — HTTP security headers ($0.02)
LoungePOST /api/news-openUnlock wire article URL
LoungePOST /api/lounge-signal-publishPublish creator signal ($1)
ResourcesPOST /api/resource-chatAgent-friendly one-turn chat ($0.05) — USDC, TCX, or credits
ResourcesPOST /api/resource-imageImage generation from prompt — base64 data URLs ($0.10)
ResourcesPOST /api/resource-scaffoldSingle-file HTML scaffold from brief ($0.10)
LoungePOST /api/lounge-signal-openUnlock 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

URLUse
GET /openapi.jsonOpenAPI 3.1 + x402/MPP payment metadata per route
GET /api/mcpJSON-RPC MCP — tools/list, tools/call
MCP RegistryOfficial 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.mdAgent Skills file for Claude/Cursor/Grok sessions
GET /.well-known/api-catalogRFC 9727 linkset — OpenAPI, MCP, x402, agent card
GET /.well-known/x402Resource fan-out for x402scan / registries
GET /api/resourcesConcierge Resources catalog (chat, image, scaffold)
GET /api/tcx-creditsTCX prepaid credit balance for Resources
GET /api/x402-configNetworks, pricing flags (no secrets)
GET /.well-known/agent-card.jsonConcierge 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 dataAsOf if 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