{ "openapi": "3.1.0", "info": { "title": "Concierge Agent API", "version": "4.0.0", "description": "Market intelligence as a service — fifteen pay-per-call endpoints. Concierge AI, macro & wire research, DeFi intel, Alpha desks, and Lounge RWA signals. No API keys. x402 + MPP discovery; USDC settlement on Solana and Base via PayAI (primary) with Dexter fallback.", "x-guidance": "Concierge Agent is a pay-per-call market intelligence API. No API keys — payment is the only gate. Discover endpoints via GET /openapi.json. Each paid route accepts POST with application/json after x402 USDC settlement on Solana or Base (PayAI (primary) · Dexter (fallback)). Flow: POST without PAYMENT-SIGNATURE → 402 + PAYMENT-REQUIRED header → pay → retry with PAYMENT-SIGNATURE (base64 payment payload). Intel routes: raw tier $0.02 — intel-tvl, intel-macro, intel-wire, intel-whales. Signal tier $0.10 — yields, wallet, verdict, alpha desks, scalp, intel-meteora. Bundle $0.25 — intel-desk-brief. Free GET — /api/concierge-intel-accuracy. MCP — POST /api/mcp (tools/list, tools/call). intel-meteora (sortByApy, poolHint, limit), intel-desk-brief (message, includeInsider). SOON holders: X-Soon-Holder-Wallet + raw tier = free calls post-launch. Concierge chat: POST /api/concierge with mode chat|enhance|image and message. Lounge: /api/news-open, /api/lounge-signal-publish ($0.02), /api/lounge-signal-open. CLI: npx agentcash discover · npx agentcash check /api/concierge-intel-tvl OpenDexter: npx -y @dexterai/opendexter · x402_search for Dexter marketplace discovery pay.sh: pay --sandbox curl /api/concierge-intel-tvl -d '{}' · pay skills search market intelligence Idempotency: optional Idempotency-Key header on POST mutating routes. Reuse the same PAYMENT-SIGNATURE after a successful x402 settlement — facilitators will not double-charge the same on-chain payment. Rate limits: soft limit 120 requests/minute per IP on /api/* — responses include X-RateLimit-Limit; 429 returns Retry-After. Discovery index: GET /.well-known/api-catalog (RFC 9727 linkset) · GET /llms.txt · GET /.well-known/agent-card.json", "x-marketplace-tags": [ "AI", "Research", "News", "Trading", "Search", "Crypto", "RWA", "Utility" ], "contact": { "name": "Concierge Agent", "url": "https://conc-exe.xyz/docs", "email": "support@conc-exe.xyz" } }, "x-service-info": { "name": "Concierge Agent", "description": "Market intelligence as a service — pay-per-call Concierge AI, macro & wire research, DeFi intel APIs, and Lounge RWA signals. USDC on Solana or Base via x402 (MPP-compatible discovery).", "tags": [ "AI", "Research", "News", "Trading", "Search", "Crypto", "RWA", "Utility" ], "iconUrl": "https://conc-exe.xyz/images/the-concierge-logo.png", "protocols": [ "x402", "mpp" ], "facilitator": "PayAI", "facilitatorUrl": "https://facilitator.payai.network", "fallbackFacilitator": "Dexter", "fallbackFacilitatorUrl": "https://x402.dexter.cash", "networks": [ "solana", "base" ] }, "servers": [ { "url": "https://conc-exe.xyz", "description": "Concierge Agent" } ], "paths": { "/api/news-open": { "post": { "operationId": "news", "summary": "Open news article", "description": "Unlock one wire headline and receive the canonical article URL.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "Search", "News", "Research", "RWA" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "url": { "type": "string", "description": "Canonical article URL" }, "unlocked": { "type": "boolean" }, "title": { "type": "string" }, "source": { "type": "string" } }, "required": [ "url", "unlocked" ] }, "example": { "url": "https://www.bbc.com/news/example", "unlocked": true, "title": "Example", "source": "BBC" } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "news" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/news-open" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "url": { "type": "string", "description": "Article URL (http/https)" }, "title": { "type": "string", "description": "Headline title" }, "source": { "type": "string", "description": "Publisher name" } }, "required": [ "url" ] }, "example": { "url": "https://www.bbc.com/news/example", "title": "Example headline", "source": "BBC" } } } } } }, "/api/concierge": { "post": { "operationId": "concierge", "summary": "Concierge AI message", "description": "One Concierge AI turn (chat, enhance, or image analysis).", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Research", "Trading", "RWA" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "reply": { "type": "string", "description": "HTML analysis from Concierge" }, "topics": { "type": "array", "items": { "type": "string" } } }, "required": [ "reply" ] }, "example": { "reply": "

Analysis…

", "topics": [ "crypto", "macro" ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "concierge" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "mode": { "type": "string", "enum": [ "chat", "enhance", "image" ], "description": "Concierge mode" }, "message": { "type": "string", "description": "User message" }, "history": { "type": "array", "description": "Prior chat turns", "items": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "user", "model" ] }, "text": { "type": "string" } }, "required": [ "role", "text" ] } }, "market": { "type": "array", "description": "Optional market ticks from UI" }, "signal": { "type": "object", "description": "Optional signal draft for enhance mode", "properties": { "title": { "type": "string" }, "summary": { "type": "string" } } } }, "required": [ "message" ] }, "example": { "mode": "chat", "message": "What is the macro outlook for BTC?", "history": [], "market": [] } } } } } }, "/api/lounge-signal-publish": { "post": { "operationId": "signal_publish", "summary": "Publish creator signal", "description": "Publish one RWA intelligence signal to the Executive Lounge feed (minimum settlement fee).", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "Crypto", "RWA" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string" }, "published": { "type": "boolean" }, "title": { "type": "string" } }, "required": [ "id", "published" ] }, "example": { "id": "sig_abc123", "published": true, "title": "BTC thesis" } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.02, "resource": "signal-publish" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/lounge-signal-publish" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "title": { "type": "string" }, "summary": { "type": "string" }, "categories": { "type": "array", "items": { "type": "string" } }, "creatorWallet": { "type": "string" }, "creatorChain": { "type": "string", "enum": [ "sol", "evm" ] } }, "required": [ "title", "summary", "categories", "creatorWallet", "creatorChain" ] }, "example": { "title": "BTC dominance roll-down thesis", "summary": "Dominance stalled at resistance; risk-curve rotation over 1–2 weeks.", "categories": [ "Crypto", "Macro" ], "creatorWallet": "0x0000000000000000000000000000000000000000", "creatorChain": "evm" } } } } } }, "/api/lounge-signal-open": { "post": { "operationId": "signal_open", "summary": "Unlock creator signal", "description": "Unlock full intelligence summary for one Lounge RWA creator signal.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "Crypto", "RWA" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "signalId": { "type": "string" }, "summary": { "type": "string" }, "title": { "type": "string" } }, "required": [ "signalId", "summary" ] }, "example": { "signalId": "sig_abc123", "summary": "Full intelligence summary…", "title": "BTC thesis" } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "signal-open" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/lounge-signal-open" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "signalId": { "type": "string", "description": "Published signal id" } }, "required": [ "signalId" ] }, "example": { "signalId": "sig_example000000000000000000000000" } } } } } }, "/api/concierge-intel-tvl": { "post": { "operationId": "intel_tvl", "summary": "Concierge Intel — TVL", "description": "Chain TVL snapshot and top DeFi protocols (DeFi Llama). JSON for agents.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "chains": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "tvl": { "type": "number" } } } }, "topProtocols": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "tvl": { "type": "number" }, "category": { "type": "string" } } } } }, "required": [ "ok" ] }, "example": { "ok": true, "chains": [ { "name": "Solana", "tvl": 4200000000 } ], "topProtocols": [] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.02, "resource": "intel-tvl" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-tvl" } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "message": { "type": "string", "description": "Optional context for logging" } }, "required": [] }, "example": {} } } } }, "get": { "operationId": "intel_tvl_get", "summary": "Concierge Intel — TVL (GET probe)", "description": "Chain TVL snapshot and top DeFi protocols (DeFi Llama). JSON for agents. Probes return 402 without payment; use POST with JSON body after settlement.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "message", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "chains": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "tvl": { "type": "number" } } } }, "topProtocols": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "tvl": { "type": "number" }, "category": { "type": "string" } } } } }, "required": [ "ok" ] }, "example": { "ok": true, "chains": [ { "name": "Solana", "tvl": 4200000000 } ], "topProtocols": [] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.02, "resource": "intel-tvl" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-tvl" } ] } }, "/api/concierge-intel-yields": { "post": { "operationId": "intel_yields", "summary": "Concierge Intel — Yields", "description": "Screened yield pools on Solana/EVM (Jupiter, Meteora, DLMM, major venues).", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "pools": { "type": "array", "items": { "type": "object", "properties": { "project": { "type": "string" }, "chain": { "type": "string" }, "apy": { "type": "number" }, "symbol": { "type": "string" } } } } }, "required": [ "ok" ] }, "example": { "ok": true, "pools": [ { "project": "meteora", "chain": "solana", "apy": 12.4, "symbol": "SOL-USDC" } ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "intel-yields" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-yields" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "chain": { "type": "string", "description": "solana | ethereum | base | arbitrum" }, "project": { "type": "string", "description": "Filter project id substring" }, "message": { "type": "string" } }, "required": [] }, "example": { "chain": "solana", "project": "meteora" } } } } }, "get": { "operationId": "intel_yields_get", "summary": "Concierge Intel — Yields (GET probe)", "description": "Screened yield pools on Solana/EVM (Jupiter, Meteora, DLMM, major venues). Probes return 402 without payment; use POST with JSON body after settlement.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "project", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "message", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "pools": { "type": "array", "items": { "type": "object", "properties": { "project": { "type": "string" }, "chain": { "type": "string" }, "apy": { "type": "number" }, "symbol": { "type": "string" } } } } }, "required": [ "ok" ] }, "example": { "ok": true, "pools": [ { "project": "meteora", "chain": "solana", "apy": 12.4, "symbol": "SOL-USDC" } ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "intel-yields" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-yields" } ] } }, "/api/concierge-intel-whales": { "post": { "operationId": "intel_whales", "summary": "Concierge Intel — Whales", "description": "Binance top-trader long/short ratios (BTC/ETH/SOL derivatives proxy).", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "positioning": { "type": "array", "items": { "type": "object", "properties": { "symbol": { "type": "string" }, "longShortRatio": { "type": "number" }, "bias": { "type": "string" } } } } }, "required": [ "ok" ] }, "example": { "ok": true, "positioning": [ { "symbol": "BTC", "longShortRatio": 1.12, "bias": "long" } ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.02, "resource": "intel-whales" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-whales" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "symbols": { "type": "array", "items": { "type": "string", "enum": [ "BTC", "ETH", "SOL" ] } } }, "required": [] }, "example": { "symbols": [ "BTC", "ETH", "SOL" ] } } } } }, "get": { "operationId": "intel_whales_get", "summary": "Concierge Intel — Whales (GET probe)", "description": "Binance top-trader long/short ratios (BTC/ETH/SOL derivatives proxy). Probes return 402 without payment; use POST with JSON body after settlement.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "symbols", "in": "query", "required": false, "schema": { "type": "array" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "positioning": { "type": "array", "items": { "type": "object", "properties": { "symbol": { "type": "string" }, "longShortRatio": { "type": "number" }, "bias": { "type": "string" } } } } }, "required": [ "ok" ] }, "example": { "ok": true, "positioning": [ { "symbol": "BTC", "longShortRatio": 1.12, "bias": "long" } ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.02, "resource": "intel-whales" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-whales" } ] } }, "/api/concierge-intel-wallet": { "post": { "operationId": "intel_wallet", "summary": "Concierge Intel — Wallet", "description": "Wallet snapshot for Solana (Helius) or EVM address acknowledgment.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "wallet": { "type": "object", "additionalProperties": false, "properties": { "chain": { "type": "string" }, "address": { "type": "string" }, "tokens": { "type": "array", "items": { "type": "object" } } }, "required": [ "chain", "address" ] } }, "required": [ "ok" ] }, "example": { "ok": true, "wallet": { "chain": "solana", "address": "7hum…", "tokens": [] } } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "intel-wallet" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-wallet" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "minProperties": 1, "description": "At least one of solAddress, evmAddress, or message (with address) is required.", "properties": { "solAddress": { "type": "string", "description": "Solana wallet address" }, "evmAddress": { "type": "string", "description": "EVM wallet address (0x…)" }, "message": { "type": "string", "description": "Optional context; may include an address" } }, "required": [] }, "example": { "solAddress": "7hum…", "message": "optional context" } } } } }, "get": { "operationId": "intel_wallet_get", "summary": "Concierge Intel — Wallet (GET probe)", "description": "Wallet snapshot for Solana (Helius) or EVM address acknowledgment. Probes return 402 without payment; use POST with JSON body after settlement.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "solAddress", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "evmAddress", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "message", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "wallet": { "type": "object", "additionalProperties": false, "properties": { "chain": { "type": "string" }, "address": { "type": "string" }, "tokens": { "type": "array", "items": { "type": "object" } } }, "required": [ "chain", "address" ] } }, "required": [ "ok" ] }, "example": { "ok": true, "wallet": { "chain": "solana", "address": "7hum…", "tokens": [] } } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "intel-wallet" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-wallet" } ] } }, "/api/concierge-intel-verdict": { "post": { "operationId": "intel_verdict", "summary": "Concierge Intel — Verdict", "description": "Structured desk verdict with Fear & Greed, positioning, yields, and optional Lounge insider signals.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading", "RWA" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "verdict": { "type": "object", "additionalProperties": false, "properties": { "signal": { "type": "string", "enum": [ "snipe", "watch", "follow", "avoid", "rebalance" ] }, "confidence": { "type": "string" }, "summary": { "type": "string" } }, "required": [ "signal" ] } }, "required": [ "ok", "verdict" ] }, "example": { "ok": true, "verdict": { "signal": "watch", "confidence": "medium", "summary": "Desk bias neutral…" } } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "intel-verdict" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-verdict" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "message": { "type": "string", "description": "Question or theme for verdict" }, "includeInsider": { "type": "boolean", "description": "Include Lounge creator signals (default true)" } }, "required": [ "message" ] }, "example": { "message": "DeFi outlook on Solana", "includeInsider": true } } } } }, "get": { "operationId": "intel_verdict_get", "summary": "Concierge Intel — Verdict (GET probe)", "description": "Structured desk verdict with Fear & Greed, positioning, yields, and optional Lounge insider signals. Probes return 402 without payment; use POST with JSON body after settlement.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading", "RWA" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "message", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "includeInsider", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "verdict": { "type": "object", "additionalProperties": false, "properties": { "signal": { "type": "string", "enum": [ "snipe", "watch", "follow", "avoid", "rebalance" ] }, "confidence": { "type": "string" }, "summary": { "type": "string" } }, "required": [ "signal" ] } }, "required": [ "ok", "verdict" ] }, "example": { "ok": true, "verdict": { "signal": "watch", "confidence": "medium", "summary": "Desk bias neutral…" } } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "intel-verdict" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-verdict" } ] } }, "/api/concierge-intel-airdrop": { "post": { "operationId": "intel_airdrop", "summary": "Concierge Intel — Airdrop", "description": "Potential airdrop candidates — Lounge insider signals first, institutional/onchain/narrative/KOL overlay.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading", "RWA" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "summary": { "type": "string" }, "candidates": { "type": "array", "items": { "type": "object", "properties": { "asset": { "type": "string" }, "thesis": { "type": "string" }, "conviction": { "type": "string" }, "insiderWeight": { "type": "string" } } } } }, "required": [ "ok", "candidates" ] }, "example": { "ok": true, "summary": "Two Solana protocols show insider + narrative airdrop overlap.", "candidates": [ { "asset": "EXAMPLE", "thesis": "Creator signal + TVL growth — monitor points program.", "conviction": "medium", "insiderWeight": "primary" } ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "intel-airdrop" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-airdrop" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "message": { "type": "string", "description": "Focus theme or protocol name" }, "chain": { "type": "string", "description": "Optional chain filter (solana, ethereum, base)" }, "limit": { "type": "number", "description": "Max candidates 1–8 (default 5)" }, "includeInsider": { "type": "boolean", "description": "Include Lounge insider signals (default true)" } }, "required": [] }, "example": { "message": "Solana ecosystem airdrop farming", "limit": 5, "includeInsider": true } } } } }, "get": { "operationId": "intel_airdrop_get", "summary": "Concierge Intel — Airdrop (GET probe)", "description": "Potential airdrop candidates — Lounge insider signals first, institutional/onchain/narrative/KOL overlay. Probes return 402 without payment; use POST with JSON body after settlement.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading", "RWA" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "message", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "includeInsider", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "summary": { "type": "string" }, "candidates": { "type": "array", "items": { "type": "object", "properties": { "asset": { "type": "string" }, "thesis": { "type": "string" }, "conviction": { "type": "string" }, "insiderWeight": { "type": "string" } } } } }, "required": [ "ok", "candidates" ] }, "example": { "ok": true, "summary": "Two Solana protocols show insider + narrative airdrop overlap.", "candidates": [ { "asset": "EXAMPLE", "thesis": "Creator signal + TVL growth — monitor points program.", "conviction": "medium", "insiderWeight": "primary" } ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "intel-airdrop" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-airdrop" } ] } }, "/api/concierge-intel-listing": { "post": { "operationId": "intel_listing", "summary": "Concierge Intel — Listing", "description": "Potential exchange listing candidates — insider-first alpha desk synthesis for agents.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading", "RWA" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "summary": { "type": "string" }, "candidates": { "type": "array", "items": { "type": "object", "properties": { "asset": { "type": "string" }, "thesis": { "type": "string" }, "conviction": { "type": "string" } } } } }, "required": [ "ok", "candidates" ] }, "example": { "ok": true, "summary": "Listing desk scan complete.", "candidates": [ { "asset": "TOKEN", "thesis": "Volume + headline listing rumor.", "conviction": "low" } ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "intel-listing" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-listing" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "message": { "type": "string", "description": "Token or listing catalyst focus" }, "chain": { "type": "string" }, "limit": { "type": "number" }, "includeInsider": { "type": "boolean" } }, "required": [] }, "example": { "message": "Potential Binance listings", "limit": 5 } } } } }, "get": { "operationId": "intel_listing_get", "summary": "Concierge Intel — Listing (GET probe)", "description": "Potential exchange listing candidates — insider-first alpha desk synthesis for agents. Probes return 402 without payment; use POST with JSON body after settlement.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading", "RWA" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "message", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "includeInsider", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "summary": { "type": "string" }, "candidates": { "type": "array", "items": { "type": "object", "properties": { "asset": { "type": "string" }, "thesis": { "type": "string" }, "conviction": { "type": "string" } } } } }, "required": [ "ok", "candidates" ] }, "example": { "ok": true, "summary": "Listing desk scan complete.", "candidates": [ { "asset": "TOKEN", "thesis": "Volume + headline listing rumor.", "conviction": "low" } ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "intel-listing" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-listing" } ] } }, "/api/concierge-intel-momentum": { "post": { "operationId": "intel_momentum", "summary": "Concierge Intel — Momentum", "description": "Large-move candidates (up or down) — insider, derivatives positioning, narrative synthesis.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading", "RWA" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "summary": { "type": "string" }, "candidates": { "type": "array", "items": { "type": "object", "properties": { "asset": { "type": "string" }, "direction": { "type": "string", "enum": [ "up", "down", "neutral", "watch" ] }, "thesis": { "type": "string" }, "conviction": { "type": "string" } } } } }, "required": [ "ok", "candidates" ] }, "example": { "ok": true, "summary": "Momentum desk: crowded positioning watchlist.", "candidates": [ { "asset": "BTC", "direction": "down", "thesis": "Crowded long — liq risk on dips.", "conviction": "medium" } ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "intel-momentum" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-momentum" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "message": { "type": "string", "description": "Asset or momentum theme" }, "chain": { "type": "string" }, "limit": { "type": "number" }, "includeInsider": { "type": "boolean" } }, "required": [] }, "example": { "message": "BTC altcoin volatility catalysts", "limit": 5, "includeInsider": true } } } } }, "get": { "operationId": "intel_momentum_get", "summary": "Concierge Intel — Momentum (GET probe)", "description": "Large-move candidates (up or down) — insider, derivatives positioning, narrative synthesis. Probes return 402 without payment; use POST with JSON body after settlement.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading", "RWA" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "message", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "chain", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "includeInsider", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "summary": { "type": "string" }, "candidates": { "type": "array", "items": { "type": "object", "properties": { "asset": { "type": "string" }, "direction": { "type": "string", "enum": [ "up", "down", "neutral", "watch" ] }, "thesis": { "type": "string" }, "conviction": { "type": "string" } } } } }, "required": [ "ok", "candidates" ] }, "example": { "ok": true, "summary": "Momentum desk: crowded positioning watchlist.", "candidates": [ { "asset": "BTC", "direction": "down", "thesis": "Crowded long — liq risk on dips.", "conviction": "medium" } ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "intel-momentum" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-momentum" } ] } }, "/api/concierge-intel-scalp": { "post": { "operationId": "intel_scalp", "summary": "Concierge Intel — Scalp", "description": "BTC/ETH/BNB/SOL USDT scalping desk — 5m & 15m Binance klines, RSI/EMA, perp overlay for agents.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "assets": { "type": "array", "items": { "type": "object", "properties": { "symbol": { "type": "string" }, "pair": { "type": "string" }, "intervals": { "type": "array" } } } } }, "required": [ "ok", "assets" ] }, "example": { "ok": true, "filters": { "symbols": [ "BTC" ], "intervals": [ "5m", "15m" ], "pairs": [ "BTC/USDT" ] }, "assets": [ { "symbol": "BTC", "pair": "BTCUSDT", "intervals": [ { "interval": "15m", "ta": { "rsi14": 52, "trend": "neutral", "lastClose": 60781 } } ] } ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "intel-scalp" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-scalp" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "message": { "type": "string", "description": "Scalp context (e.g. BTC 15m entry)" }, "symbols": { "type": "array", "items": { "type": "string", "enum": [ "BTC", "ETH", "BNB", "SOL" ] } }, "intervals": { "type": "array", "items": { "type": "string", "enum": [ "5m", "15m" ] } } }, "required": [] }, "example": { "message": "scalp BTC 15m", "symbols": [ "BTC" ], "intervals": [ "5m", "15m" ] } } } } }, "get": { "operationId": "intel_scalp_get", "summary": "Concierge Intel — Scalp (GET probe)", "description": "BTC/ETH/BNB/SOL USDT scalping desk — 5m & 15m Binance klines, RSI/EMA, perp overlay for agents. Probes return 402 without payment; use POST with JSON body after settlement.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "message", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "symbols", "in": "query", "required": false, "schema": { "type": "array" } }, { "name": "intervals", "in": "query", "required": false, "schema": { "type": "array" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "assets": { "type": "array", "items": { "type": "object", "properties": { "symbol": { "type": "string" }, "pair": { "type": "string" }, "intervals": { "type": "array" } } } } }, "required": [ "ok", "assets" ] }, "example": { "ok": true, "filters": { "symbols": [ "BTC" ], "intervals": [ "5m", "15m" ], "pairs": [ "BTC/USDT" ] }, "assets": [ { "symbol": "BTC", "pair": "BTCUSDT", "intervals": [ { "interval": "15m", "ta": { "rsi14": 52, "trend": "neutral", "lastClose": 60781 } } ] } ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "intel-scalp" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-scalp" } ] } }, "/api/concierge-intel-macro": { "post": { "operationId": "intel_macro", "summary": "Concierge Intel — Macro", "description": "Macro snapshot — SPX, VIX, DXY, gold, BTC/ETH marks, Fear & Greed, Treasury yields, and central-bank calendar.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "Research", "News", "Utility" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "marks": { "type": "array", "items": { "type": "object", "properties": { "symbol": { "type": "string" }, "price": { "type": "string" }, "change24h": { "type": "string" } } } }, "sentiment": { "type": "object", "properties": { "index": { "type": "number" }, "label": { "type": "string" } } }, "macro": { "type": "object" } }, "required": [ "ok" ] }, "example": { "ok": true, "marks": [ { "symbol": "SPX", "price": "5,240.10", "change24h": "+0.42%" } ], "sentiment": { "index": 62, "label": "Greed" }, "macro": { "upcomingEvents": [ { "label": "FOMC decision", "when": "2026-03-18" } ] } } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.02, "resource": "intel-macro" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-macro" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "message": { "type": "string", "description": "Optional context for logging" } }, "required": [] }, "example": {} } } } }, "get": { "operationId": "intel_macro_get", "summary": "Concierge Intel — Macro (GET probe)", "description": "Macro snapshot — SPX, VIX, DXY, gold, BTC/ETH marks, Fear & Greed, Treasury yields, and central-bank calendar. Probes return 402 without payment; use POST with JSON body after settlement.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "Research", "News", "Utility" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "message", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "marks": { "type": "array", "items": { "type": "object", "properties": { "symbol": { "type": "string" }, "price": { "type": "string" }, "change24h": { "type": "string" } } } }, "sentiment": { "type": "object", "properties": { "index": { "type": "number" }, "label": { "type": "string" } } }, "macro": { "type": "object" } }, "required": [ "ok" ] }, "example": { "ok": true, "marks": [ { "symbol": "SPX", "price": "5,240.10", "change24h": "+0.42%" } ], "sentiment": { "index": 62, "label": "Greed" }, "macro": { "upcomingEvents": [ { "label": "FOMC decision", "when": "2026-03-18" } ] } } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.02, "resource": "intel-macro" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-macro" } ] } }, "/api/concierge-intel-wire": { "post": { "operationId": "intel_wire", "summary": "Concierge Intel — Wire", "description": "Wire headline digest — live RSS plus persisted Lounge feed; optional category or message filter.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "News", "Research", "Search" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "headlines": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "source": { "type": "string" }, "category": { "type": "string" }, "url": { "type": "string" }, "origin": { "type": "string", "enum": [ "live", "lounge" ] } } } } }, "required": [ "ok", "headlines" ] }, "example": { "ok": true, "headlines": [ { "title": "Oil supply risk rises on shipping disruption", "source": "Reuters", "category": "Geopolitics", "origin": "lounge" } ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.02, "resource": "intel-wire" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-wire" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "message": { "type": "string", "description": "Relevance filter for Lounge wire memory" }, "category": { "type": "string", "description": "Category filter (Macro, Geopolitics, Crypto, …)" }, "limit": { "type": "number", "description": "Max headlines 1–20 (default 10)" } }, "required": [] }, "example": { "category": "Geopolitics", "limit": 8, "message": "Middle East oil supply" } } } } }, "get": { "operationId": "intel_wire_get", "summary": "Concierge Intel — Wire (GET probe)", "description": "Wire headline digest — live RSS plus persisted Lounge feed; optional category or message filter. Probes return 402 without payment; use POST with JSON body after settlement.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "20000", "currency": "USDC", "intent": "charge", "description": "$0.02 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "News", "Research", "Search" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "message", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "number" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "headlines": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "source": { "type": "string" }, "category": { "type": "string" }, "url": { "type": "string" }, "origin": { "type": "string", "enum": [ "live", "lounge" ] } } } } }, "required": [ "ok", "headlines" ] }, "example": { "ok": true, "headlines": [ { "title": "Oil supply risk rises on shipping disruption", "source": "Reuters", "category": "Geopolitics", "origin": "lounge" } ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.02, "resource": "intel-wire" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-wire" } ] } }, "/api/concierge-intel-meteora": { "post": { "operationId": "intel_meteora", "summary": "Concierge Intel — Meteora DLMM", "description": "Meteora DLMM pool deep-dive — TVL, APY, bin step, volume, IL risk flags (Solana-native moat).", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading", "Utility" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "pools": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "apy": { "type": "string" }, "tvlUsd": { "type": "string" }, "riskFlags": { "type": "array", "items": { "type": "string" } } } } } }, "required": [ "ok", "pools" ] }, "example": { "ok": true, "pools": [ { "name": "SOL-USDC", "apy": "24.50%", "tvlUsd": "$12.4M", "riskFlags": [] } ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "intel-meteora" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-meteora" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "sortByApy": { "type": "boolean", "description": "Sort by APY instead of TVL" }, "limit": { "type": "number", "description": "Max pools 1–20" }, "poolHint": { "type": "string", "description": "Substring filter on pool name" } }, "required": [] }, "example": { "sortByApy": true, "limit": 8, "poolHint": "SOL" } } } } }, "get": { "operationId": "intel_meteora_get", "summary": "Concierge Intel — Meteora DLMM (GET probe)", "description": "Meteora DLMM pool deep-dive — TVL, APY, bin step, volume, IL risk flags (Solana-native moat). Probes return 402 without payment; use POST with JSON body after settlement.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "100000", "currency": "USDC", "intent": "charge", "description": "$0.10 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Crypto", "Trading", "Utility" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "sortByApy", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "poolHint", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "pools": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "apy": { "type": "string" }, "tvlUsd": { "type": "string" }, "riskFlags": { "type": "array", "items": { "type": "string" } } } } } }, "required": [ "ok", "pools" ] }, "example": { "ok": true, "pools": [ { "name": "SOL-USDC", "apy": "24.50%", "tvlUsd": "$12.4M", "riskFlags": [] } ] } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.1, "resource": "intel-meteora" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-meteora" } ] } }, "/api/concierge-intel-desk-brief": { "post": { "operationId": "intel_desk_brief", "summary": "Concierge Intel — Desk brief", "description": "Composite brief — macro + Meteora yields + desk verdict + optional Lounge insider overlay.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.250000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "250000", "currency": "USDC", "intent": "charge", "description": "$0.25 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "250000", "currency": "USDC", "intent": "charge", "description": "$0.25 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Research", "Trading", "RWA" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Optional client-generated key (UUID recommended). Reuse the same key when retrying after network failures. For paid routes, also reuse the same PAYMENT-SIGNATURE — facilitators treat a settled payment as idempotent.", "schema": { "type": "string", "maxLength": 128, "example": "550e8400-e29b-41d4-a716-446655440000" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "brief": { "type": "object", "properties": { "headline": { "type": "string" }, "signal": { "type": "string" }, "confidence": { "type": "string" } } } }, "required": [ "ok", "brief" ] }, "example": { "ok": true, "brief": { "headline": "Constructive risk-on with Solana yield rotation", "signal": "watch", "confidence": "medium" } } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.25, "resource": "intel-desk-brief" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-desk-brief" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "message": { "type": "string", "description": "Desk brief context" }, "includeInsider": { "type": "boolean", "description": "Include Lounge creator signals" } }, "required": [] }, "example": { "message": "morning Solana desk brief", "includeInsider": true } } } } }, "get": { "operationId": "intel_desk_brief_get", "summary": "Concierge Intel — Desk brief (GET probe)", "description": "Composite brief — macro + Meteora yields + desk verdict + optional Lounge insider overlay. Probes return 402 without payment; use POST with JSON body after settlement.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.250000" }, "protocols": [ { "x402": { "network": "solana", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "base", "facilitator": "https://facilitator.payai.network", "role": "primary" } }, { "x402": { "network": "solana", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "x402": { "network": "base", "facilitator": "https://x402.dexter.cash", "role": "fallback" } }, { "mpp": { "method": "solana", "intent": "charge", "currency": "USDC" } } ], "offers": [ { "protocol": "x402", "amount": "250000", "currency": "USDC", "intent": "charge", "description": "$0.25 USDC via PayAI (primary; Dexter fallback on Solana/Base)" }, { "protocol": "mpp", "amount": "250000", "currency": "USDC", "intent": "charge", "description": "$0.25 USDC — x402 settlement compatible with MPP clients" } ] }, "tags": [ "AI", "Research", "Trading", "RWA" ], "parameters": [ { "name": "X-Agent-Id", "in": "header", "required": false, "description": "Registered agent identity (agt_…) for attribution and discovery", "schema": { "type": "string", "pattern": "^agt_[a-zA-Z0-9]+$", "example": "agt_demo0001" } }, { "name": "message", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "includeInsider", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "security": [ { "x402Payment": [] } ], "responses": { "200": { "description": "Success after payment", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ok": { "type": "boolean" }, "brief": { "type": "object", "properties": { "headline": { "type": "string" }, "signal": { "type": "string" }, "confidence": { "type": "string" } } } }, "required": [ "ok", "brief" ] }, "example": { "ok": true, "brief": { "headline": "Constructive risk-on with Solana yield rotation", "signal": "watch", "confidence": "medium" } } } } }, "400": { "description": "Invalid request body or parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Invalid JSON body", "code": "invalid_request" } } } }, "402": { "description": "Payment Required", "headers": { "PAYMENT-REQUIRED": { "description": "Base64 JSON x402 payment requirements (MPP-compatible)", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Soft rate limit per IP per minute", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Payment required", "code": "payment_required", "priceUsdc": 0.25, "resource": "intel-desk-brief" } } } }, "405": { "description": "HTTP method not allowed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Method not allowed", "code": "method_not_allowed" } } } }, "429": { "description": "Rate limit exceeded — back off and retry after Retry-After seconds", "headers": { "Retry-After": { "description": "Seconds until the client may retry", "schema": { "type": "integer", "example": 60 } }, "X-RateLimit-Limit": { "description": "Maximum requests per window", "schema": { "type": "integer", "example": 120 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Too many requests — retry after the Retry-After interval", "code": "rate_limited" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" }, "example": { "error": "Concierge could not process this request. Try a shorter question.", "code": "internal_error" } } } } }, "servers": [ { "url": "https://conc-exe.xyz/api/concierge-intel-desk-brief" } ] } } }, "x-discovery": { "ownershipProofs": [ "0xb85c83cc448edca8eb724f5d79b523faff9375a7" ], "x402scan": "https://www.x402scan.com/resources/register", "mppscan": "https://www.mppscan.com/", "mppscanRegister": "https://www.mppscan.com/register", "mppscanServer": "https://conc-exe.xyz/go/mppscan", "mppscanProfileLink": "https://conc-exe.xyz/go/mppscan", "mppscanDiscovery": "https://www.mppscan.com/discovery", "agentcashDiscover": "npx -y @agentcash/discovery@latest discover https://conc-exe.xyz", "agentcashCheckIntel": "npx -y @agentcash/discovery@latest check https://conc-exe.xyz/api/concierge-intel-tvl", "dexter": "https://dexter.cash/", "dexterDocs": "https://docs.dexter.cash/", "dexterFacilitator": "https://x402.dexter.cash", "dexterFacilitatorDocs": "https://docs.dexter.cash/docs/facilitator-and-chains/", "dexterSupported": "https://x402.dexter.cash/supported", "openDexter": "https://dexter.cash/opendexter", "openDexterMcp": "https://open.dexter.cash/mcp", "openDexterNpm": "https://www.npmjs.com/package/@dexterai/opendexter", "dexterSellers": "https://dexter.cash/sellers", "dexterMarketplaceApi": "https://api.dexter.cash/api/facilitator/marketplace/resources?search=concierge&limit=10", "dexterSearchIntel": "x402_search(query: \"market intelligence\", network: \"solana\")", "openDexterInstall": "npx -y @dexterai/opendexter", "dexterProbeIntel": "https://conc-exe.xyz/api/concierge-intel-tvl", "paysh": "https://pay.sh/", "payshCatalog": "https://pay.sh/api/catalog", "payshDocs": "https://pay.sh/docs/overview/index.md", "payshContribute": "https://github.com/solana-foundation/pay-skills/blob/main/CONTRIBUTING.md", "payshProviderFqn": "conc-exe/concierge-agent", "payshSkillsSearch": "pay skills search \"market intelligence\"", "payshCurlIntel": "pay curl https://conc-exe.xyz/api/concierge-intel-verdict -d '{\"message\":\"Solana DeFi outlook\",\"includeInsider\":true}'", "payshCurlConcierge": "pay curl https://conc-exe.xyz/api/concierge -d '{\"mode\":\"chat\",\"message\":\"BTC outlook\"}'", "payshSandboxCurl": "pay --sandbox curl https://conc-exe.xyz/api/concierge-intel-tvl -d '{}'", "serviceName": "Concierge Agent", "description": "Market intelligence as a service — pay-per-call Concierge AI, macro & wire research, DeFi intel APIs, and Lounge RWA signals. USDC on Solana or Base via x402 (MPP-compatible discovery).", "tags": [ "AI", "Research", "News", "Trading", "Search", "Crypto", "RWA", "Utility" ], "iconUrl": "https://conc-exe.xyz/images/the-concierge-logo.png", "facilitator": "PayAI", "facilitatorUrl": "https://facilitator.payai.network", "fallbackFacilitator": "Dexter", "fallbackFacilitatorUrl": "https://x402.dexter.cash", "protocols": [ "x402", "mpp" ] }, "tags": [ { "name": "news", "description": "Wire article unlock" }, { "name": "concierge", "description": "Concierge AI" }, { "name": "intel", "description": "Concierge DeFi intelligence APIs" }, { "name": "research", "description": "Macro snapshot and wire headline digest" }, { "name": "creator", "description": "Creator signals & RWA" }, { "name": "rwa", "description": "Real World Asset intelligence certificates" } ], "components": { "schemas": { "ApiError": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "string", "description": "Human-readable error message" }, "code": { "type": "string", "description": "Stable machine-readable error code when available", "enum": [ "invalid_request", "payment_required", "payment_failed", "rate_limited", "method_not_allowed", "not_found", "internal_error" ] }, "detail": { "type": "string", "description": "Additional context (may mirror error in dev)" }, "resource": { "type": "string", "description": "x402 resource kind when payment-related" }, "priceUsdc": { "type": "number", "description": "Quoted USDC price on 402 responses" } } } }, "securitySchemes": { "x402Payment": { "type": "apiKey", "in": "header", "name": "PAYMENT-SIGNATURE", "description": "Base64 x402 payment payload after USDC settlement. Omit on first request to receive 402 + PAYMENT-REQUIRED." }, "soonHolder": { "type": "apiKey", "in": "header", "name": "X-Soon-Holder-Wallet", "description": "Post-launch: Solana wallet with SOON Deluxe balance for free raw-tier intel calls (no PAYMENT-SIGNATURE)." } } } }