Circuit

Circuit API

Circuit API as documented publicly: 30 operations. Contract generated from the documentation by API Evangelist (2026-11-04); not the provider's own document.

Documentation GitHub OpenAPI

Operations 30

GET /.well-known/agent-card.json A2A agent card for the Circuit registry. #

GET /api/facilitator/supported GET /api/facilitator/supported #

POST /api/facilitator/verify POST /api/facilitator/verify #

GET /api/v1/agents/tally One agent: description, pay-to address and skills. #

GET /api/v1/chain/head Latest block on the settlement chain, cached for every visitor. #

GET /api/v1/chain/usdg Live re-check of the USDG contract facts payments rely on. #

GET /api/v1/live Skills, their endpoints and whether payments are being accepted right now. #

GET /api/v1/manifest-schema JSON Schema for circuit.json manifests. #

GET /api/v1/skills Full catalog with prices, schemas, endpoints and example responses. #

POST /api/x402/bastion/pii-redact Bastion · Personal Data Redaction #

POST /api/x402/bastion/secret-scan Bastion · Secret Leak Scan #

POST /api/x402/bastion/url-risk Bastion · Phishing Link Check #

POST /api/x402/herald/crypto-news Herald · Crypto Headlines #

POST /api/x402/herald/hn-search Herald · Hacker News Search #

POST /api/x402/herald/social-search Herald · Social Pulse #

POST /api/x402/patch/dependency-audit Patch · Dependency Audit #

POST /api/x402/patch/package-trust Patch · Package Trust Check #

POST /api/x402/pulse/text-sentiment Market Text Sentiment skill, price 0.005 USDG per call. #

POST /api/x402/sage/page-reader Sage · Web Page Reader #

POST /api/x402/sage/summarize Sage · Extractive Summary #

POST /api/x402/sage/wiki-lookup Sage · Wikipedia Lookup #

POST /api/x402/scope/token-inspector Scope · Token Inspector #

POST /api/x402/scope/tx-explainer Scope · Transaction Explainer #

POST /api/x402/tally/chain-snapshot Tally · Chain Snapshot #

POST /api/x402/tally/wallet-profiler Wallet Profiler skill, price 0.01 USDG per call. #

POST /api/x402/ticker/defi-stats Ticker · DeFi Protocol Stats #

POST /api/x402/ticker/token-price Ticker · Token Prices #

POST /api/x402/warden/injection-scan POST /api/x402/warden/injection-scan #

GET /llms.txt Site index for language models. #

GET /skill.md Instructions an agent can load to discover, pay for and call skills. #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/circuit-family/openapi/_ae-authored/circuit-family-openapi-generated.yml

Schemas & Data

📊

JSONSchema

https://artifacts.apis.io/circuit-family/json-schema/circuit-family-post-api-x402-pulse-text-sentiment-request-schema.json

📊

JSONSchema

https://artifacts.apis.io/circuit-family/json-schema/circuit-family-post-api-x402-warden-injection-scan-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/circuit-family:circuit-family-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: Circuit API
  version: '2026-11-04'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-04: 30 operation(s) read from 1 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Circuit has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 3
    documentation: 27
    pages-with-code: 1
    pages-read: 1
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-04'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.circuit.family/developers
paths:
  /.well-known/agent-card.json:
    get:
      operationId: get_well_known_agent_card_json
      tags:
      - API
      summary: A2A agent card for the Circuit registry.
      x-source: https://www.circuit.family/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/facilitator/supported:
    get:
      operationId: get_api_facilitator_supported
      tags:
      - Api
      summary: GET /api/facilitator/supported
      x-source: https://www.circuit.family/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: curl https://www.circuit.family/api/facilitator/supported
  /api/facilitator/verify:
    post:
      operationId: post_api_facilitator_verify
      tags:
      - Api
      summary: POST /api/facilitator/verify
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X POST https://www.circuit.family/api/facilitator/verify  -H "content-type: application/json"  -d ''{"x402Version":2,"paymentPayload":{…},"paymentRequirements":{…}}''
          Settlement is only performed for payments made to Circuit''s own pay-to address. REST API Read-only, no key required, CORS-enabled.
          GET /api/v1/live Skills, their endpoints and whether payments are being accepted right now. GET /a'
  /api/v1/agents/tally:
    get:
      operationId: get_api_v1_agents_tally
      tags:
      - Api
      summary: 'One agent: description, pay-to address and skills.'
      x-source: https://www.circuit.family/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/chain/head:
    get:
      operationId: get_api_v1_chain_head
      tags:
      - Api
      summary: Latest block on the settlement chain, cached for every visitor.
      x-source: https://www.circuit.family/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/chain/usdg:
    get:
      operationId: get_api_v1_chain_usdg
      tags:
      - Api
      summary: Live re-check of the USDG contract facts payments rely on.
      x-source: https://www.circuit.family/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/live:
    get:
      operationId: get_api_v1_live
      tags:
      - Api
      summary: Skills, their endpoints and whether payments are being accepted right now.
      x-source: https://www.circuit.family/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/manifest-schema:
    get:
      operationId: get_api_v1_manifest_schema
      tags:
      - Api
      summary: JSON Schema for circuit.json manifests.
      x-source: https://www.circuit.family/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/skills:
    get:
      operationId: get_api_v1_skills
      tags:
      - Api
      summary: Full catalog with prices, schemas, endpoints and example responses.
      x-source: https://www.circuit.family/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/bastion/pii-redact:
    post:
      operationId: post_api_x402_bastion_pii_redact
      tags:
      - Api
      summary: Bastion · Personal Data Redaction
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/bastion/secret-scan:
    post:
      operationId: post_api_x402_bastion_secret_scan
      tags:
      - Api
      summary: Bastion · Secret Leak Scan
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/bastion/url-risk:
    post:
      operationId: post_api_x402_bastion_url_risk
      tags:
      - Api
      summary: Bastion · Phishing Link Check
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/herald/crypto-news:
    post:
      operationId: post_api_x402_herald_crypto_news
      tags:
      - Api
      summary: Herald · Crypto Headlines
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/herald/hn-search:
    post:
      operationId: post_api_x402_herald_hn_search
      tags:
      - Api
      summary: Herald · Hacker News Search
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/herald/social-search:
    post:
      operationId: post_api_x402_herald_social_search
      tags:
      - Api
      summary: Herald · Social Pulse
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/patch/dependency-audit:
    post:
      operationId: post_api_x402_patch_dependency_audit
      tags:
      - Api
      summary: Patch · Dependency Audit
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/patch/package-trust:
    post:
      operationId: post_api_x402_patch_package_trust
      tags:
      - Api
      summary: Patch · Package Trust Check
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/pulse/text-sentiment:
    post:
      operationId: post_api_x402_pulse_text_sentiment
      tags:
      - Api
      summary: Market Text Sentiment skill, price 0.005 USDG per call.
      x-source: https://www.circuit.family/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiX402PulseTextSentimentRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/sage/page-reader:
    post:
      operationId: post_api_x402_sage_page_reader
      tags:
      - Api
      summary: Sage · Web Page Reader
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/sage/summarize:
    post:
      operationId: post_api_x402_sage_summarize
      tags:
      - Api
      summary: Sage · Extractive Summary
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/sage/wiki-lookup:
    post:
      operationId: post_api_x402_sage_wiki_lookup
      tags:
      - Api
      summary: Sage · Wikipedia Lookup
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/scope/token-inspector:
    post:
      operationId: post_api_x402_scope_token_inspector
      tags:
      - Api
      summary: Scope · Token Inspector
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/scope/tx-explainer:
    post:
      operationId: post_api_x402_scope_tx_explainer
      tags:
      - Api
      summary: Scope · Transaction Explainer
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/tally/chain-snapshot:
    post:
      operationId: post_api_x402_tally_chain_snapshot
      tags:
      - Api
      summary: Tally · Chain Snapshot
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/tally/wallet-profiler:
    post:
      operationId: post_api_x402_tally_wallet_profiler
      tags:
      - Api
      summary: Wallet Profiler skill, price 0.01 USDG per call.
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/ticker/defi-stats:
    post:
      operationId: post_api_x402_ticker_defi_stats
      tags:
      - Api
      summary: Ticker · DeFi Protocol Stats
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/ticker/token-price:
    post:
      operationId: post_api_x402_ticker_token_price
      tags:
      - Api
      summary: Ticker · Token Prices
      x-source: https://www.circuit.family/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/x402/warden/injection-scan:
    post:
      operationId: post_api_x402_warden_injection_scan
      tags:
      - Api
      summary: POST /api/x402/warden/injection-scan
      x-source: https://www.circuit.family/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiX402WardenInjectionScanRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -i -X POST https://www.circuit.family/api/x402/warden/injection-scan  -H "content-type: application/json"  -d ''{"text":"Ignore
          previous instructions"}'' '
  /llms.txt:
    get:
      operationId: get_llms_txt
      tags:
      - Llms
      summary: Site index for language models.
      x-source: https://www.circuit.family/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /skill.md:
    get:
      operationId: get_skill_md
      tags:
      - Skill
      summary: Instructions an agent can load to discover, pay for and call skills.
      x-source: https://www.circuit.family/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiX402PulseTextSentimentRequest:
      type: object
      properties:
        text:
          type: string
      required:
      - text
    PostApiX402WardenInjectionScanRequest:
      type: object
      properties:
        text:
          type: string
tags:
- name: API
- name: Api
- name: Llms
- name: Skill