Get started

Quickstart

Your first paid Concierge call in under two minutes.

Base URL: https://conc-exe.xyz (or your deployment origin)

Endpoint: POST /api/concierge

Price: 0.1 USDC · atomic amount 100000 (6 decimals)

1. Probe without payment

curl -s -X POST "https://conc-exe.xyz/api/concierge" \
  -H "Content-Type: application/json" \
  -d '{"mode":"chat","message":"BTC outlook 24h"}' \
  -D - -o /dev/null | head -20

Expect 402 and a PAYMENT-REQUIRED header (base64 JSON with accepts for Base and/or Solana USDC, plus optional Token Pay entries when merchants are live).

2. Sign and pay (x402 client)

Use an x402-capable HTTP client from the PayAI / x402 ecosystem — it decodes requirements, signs USDC, and retries automatically.

Primary facilitator: facilitator.payai.network · Fallback: x402.dexter.cash (OpenDexter marketplace). Protocol: x402 v2.

3. Retry with PAYMENT-SIGNATURE

Second POST with the same JSON body plus header:

PAYMENT-SIGNATURE: <base64 payment payload>

On success: 200, JSON with reply (HTML), topics, marketLive, dataAsOf, and header PAYMENT-RESPONSE with settlement hash.

Structured DeFi & Alpha (no chat)

Same x402 flow on Intel routes — example hottest Meteora DLMM yields:

POST /api/concierge-intel-yields
{ "chain": "solana", "project": "meteora" }

Alpha desks (airdrop, listing, momentum):

POST /api/concierge-intel-momentum
{ "message": "BTC volatility", "limit": 5, "includeInsider": true }

See Intel APIs · full builder guide: For Builders.

Research intel (Poncho-friendly)

pay --sandbox curl https://conc-exe.xyz/api/concierge-intel-macro -d '{}'

pay --sandbox curl https://conc-exe.xyz/api/concierge-intel-wire \
  -d '{"category":"Geopolitics","limit":5}'

Also callable from Poncho via x402scan discovery. See Intel APIs.

pay.sh (fastest for agents)

The pay.sh CLI handles 402 automatically — no manual PAYMENT-SIGNATURE wiring:

pay --sandbox curl https://conc-exe.xyz/api/concierge-intel-tvl -d '{}'

pay --sandbox curl https://conc-exe.xyz/api/concierge \
  -d '{"mode":"chat","message":"BTC outlook 24h"}'

Works with Claude Code and Codex via pay --sandbox claude. Full guide: pay.sh

MPP / AgentCash (optional)

Install all Concierge skills from the MPPscan listing:

npx agentcash add https://conc-exe.xyz

Validate discovery: npx -y @agentcash/discovery@latest discover https://conc-exe.xyz

Discovery

URLPurpose
GET /openapi.jsonOpenAPI 3.1 + x402/mpp payment metadata
GET /.well-known/x402x402 resource fan-out
GET /api/x402-configPublic payment flags (no secrets)
GET /api/token-payToken Pay merchant registry (beta partners)
GET /.well-known/agent-card.jsonAgent registry

Concierge · Executive Lounge