quotient-api

Par bankrbot · skills

Accède à l'intelligence de marché Quotient via des micropaiements x402 ou une authentification par clé API, avec gestion explicite du challenge/règlement 402 lors de l'utilisation de x402.

npx skills add https://github.com/bankrbot/skills --skill quotient-api

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-key quand 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 via X-API-Key avec 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

  1. Envoyez une requête à la passerelle Quotient sans en-têtes de paiement.
  2. Si la réponse est 402, analysez PAYMENT-REQUIRED.
  3. Signez le paiement et réessayez avec PAYMENT-SIGNATURE.
  4. En cas de succès, analysez PAYMENT-RESPONSE.
  5. Appliquez les règles de retry/backoff pour 429 et 5xx transitoires.

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 402 runtime 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 402 runtime 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évision
  • GET /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 condition
  • GET /api/v1/markets/{slug}/intelligence - intelligence complète sur un marché unique
  • GET /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

Skills similaires