Skill Quotient API
Utilisez ce skill quand un agent a besoin d'une intelligence de marché Quotient et doit exécuter correctement les flux de paiement x402.
URL de base
QUOTIENT_BASE_URL:https://q-api.quotient.social- Utilisez cette seule origine pour les requêtes runtime et les documents de discovery (
/openapi.json,/api/public/pricing,/llms.txt,/skill/*).
Modèle d'accès
- Utilisez x402 ou une clé API pour les requêtes monétisées.
- Préférez les outils de portefeuille Bankr quand disponibles.
- Supportez les clients x402 SIWE/SIWX vanille comme fallback de première classe.
- Incluez
x-quotient-api-keyquand disponible ; les requêtes runtime peuvent être autorisées via soit la gestion de paiement x402, soit l'authentification par clé API. - Si vous utilisez la signature Bankr (
/agent/sign), fournissez une clé API Bankr viaX-API-Keyavec l'accès Agent API activé et les permissions de signature (pas en lecture seule).
Obtenir une clé API Quotient
- Inscrivez-vous (ou connectez-vous) à
https://dev.quotient.social. - La création de compte supporte :
- connexion par email
- connexion Google
- Les nouveaux comptes incluent des crédits gratuits, afin que les utilisateurs puissent essayer l'API avant de payer.
- Après inscription/connexion, créez ou copiez une clé API Quotient depuis les paramètres de compte Quotient/zone développeur.
- Passez la clé à l'agent via config/secrets en tant que
x-quotient-api-key(ou équivalent env/secret wiring utilisé par votre client).
Chemin d'inscription opérateur vs agent
- Préféré : l'opérateur humain complète l'inscription/connexion et la création de clé, puis injecte la clé API dans la config de l'agent.
- Chemin agent en libre-service optionnel : si votre runtime supporte l'automatisation de navigateur plus le stockage sécurisé des secrets, l'agent peut effectuer l'inscription/connexion à
https://dev.quotient.social, générer une clé et la stocker pour les requêtes ultérieures. - Si l'authentification interactive (vérification email, OAuth Google, CAPTCHA, 2FA, prompts de politique) ne peut pas être complétée programmatiquement, reveniez au chemin de l'opérateur humain.
Checklist d'appel API x402
- Envoyez une requête à la passerelle Quotient sans en-têtes de paiement.
- Si la réponse est
402, analysezPAYMENT-REQUIRED. - Signez le paiement et réessayez avec
PAYMENT-SIGNATURE. - En cas de succès, analysez
PAYMENT-RESPONSE. - Appliquez les règles de retry/backoff pour
429et5xxtransitoires.
Preflight requis (déterministe)
Avant le premier appel API dans une session, récupérez ces endpoints de discovery :
/openapi.json/api/public/pricing- Traitez OpenAPI comme l'endpoint canonique et les métadonnées d'invocation.
- Traitez l'endpoint de tarification comme des métadonnées de facturation/réseau supplémentaires (assets, chaînes, mapping de crédits), et traitez les données de challenge
402runtime comme faisant autorité. - Mettez en cache les métadonnées de tarification et actualisez périodiquement (par exemple, toutes les 15-60 minutes) ou immédiatement quand les détails
402runtime diffèrent du cache.
Endpoints canoniques et discovery
- OpenAPI:
/openapi.json - Endpoint de discovery de tarification:
GET /api/public/pricing - Index IA:
/llms.txt
Endpoints principaux
GET /api/v1/markets- marchés couverts avec statut de prévisionGET /api/v1/markets/mispriced- marchés où Q diverge des cotes du marchéGET /api/v1/markets/lookup- recherche par lot via slugs ou IDs de conditionGET /api/v1/markets/{slug}/intelligence- intelligence complète sur un marché uniqueGET /api/v1/markets/{slug}/signals- signaux d'analyste paginés pour un marché
Références
- Référence API:
/skill/references/api-reference.md - Flux x402 préféré Bankr:
/skill/references/bankr-preferred-flow.md - Flux x402 vanille:
/skill/references/vanilla-x402-flow.md - Gestion des erreurs:
/skill/references/error-handling.md