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 →

Fifteen endpoints — 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-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
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)
LoungePOST /api/news-openUnlock wire article URL
LoungePOST /api/lounge-signal-publishPublish creator signal ($1)
LoungePOST /api/lounge-signal-openUnlock 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

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.0.1 — guide
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/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 — Optional proxy via Corbits Marketplace, list on MPPscan, MCP Registry, or pay.sh pay-skills catalog.

Concierge Agent · Executive Lounge