Hive Civilization Cns API

The cns API from Hive Civilization — 4 operation(s) for cns.

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/cns/health Check CNS transfer service health · Health #
Ask an LLM
“Is the CNS stablecoin transfer service up?”
“Can I health-check CNS before sending a transfer?”
Tell an agent
Check CNS health.
Ping the CNS transfer service.
POST /v1/cns/transfer Send a compliant stablecoin transfer · Transfer #
Ask an LLM
“How do I transfer USDC between two DIDs with compliance controls applied?”
“Which stablecoins can a CNS transfer move?”
Tell an agent
Transfer {amount} {asset} from {from_did} to {to_did}.
Send {amount} {asset} on {chain} from {from_did} to {to_did} with memo {memo}.
GET /v1/cns/transfer/{transfer_id} Get a CNS transfer · Transfer Get #
Ask an LLM
“What's the status of a stablecoin transfer I sent?”
“How do I look up a CNS transfer by its ID?”
Tell an agent
Show CNS transfer {transfer_id}.
Check the status of transfer {transfer_id}.
GET /v1/cns/benchmark Get CNS transfer benchmarks · Benchmark #
Ask an LLM
“How fast does the CNS transfer service perform?”
“Are there published benchmark numbers for CNS?”
Tell an agent
Show CNS benchmark results.
Fetch the CNS performance benchmark.

Documentation

Specifications

Other Resources

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/thehiveryiq-com:thehiveryiq-com-cns-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

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

OpenAPI Specification

thehiveryiq-com-cns-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: HiveMorph v0.1 Cns API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: cns
paths:
  /v1/cns/health:
    get:
      tags:
      - cns
      summary: Health
      operationId: health_v1_cns_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Health V1 Cns Health Get
  /v1/cns/transfer:
    post:
      tags:
      - cns
      summary: Transfer
      operationId: transfer_v1_cns_transfer_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TransferRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransferResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/cns/transfer/{transfer_id}:
    get:
      tags:
      - cns
      summary: Transfer Get
      operationId: transfer_get_v1_cns_transfer__transfer_id__get
      parameters:
      - name: transfer_id
        in: path
        required: true
        schema:
          type: string
          title: Transfer Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Transfer Get V1 Cns Transfer  Transfer Id  Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/cns/benchmark:
    get:
      tags:
      - cns
      summary: Benchmark
      operationId: benchmark_v1_cns_benchmark_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Benchmark V1 Cns Benchmark Get
components:
  schemas:
    TransferResponse:
      properties:
        transfer_id:
          type: string
          title: Transfer Id
        status:
          type: string
          enum:
          - settled
          - rejected
          title: Status
        submitted_at:
          type: string
          title: Submitted At
        settled_at:
          type: string
          title: Settled At
        wall_clock_ms:
          type: number
          title: Wall Clock Ms
        off_chain_ms:
          type: number
          title: Off Chain Ms
        on_chain_ms:
          type: number
          title: On Chain Ms
        transfer:
          $ref: '#/components/schemas/TransferRequest'
        compliance_bundle:
          $ref: '#/components/schemas/ComplianceBundle'
        settlement_envelope:
          $ref: '#/components/schemas/SettlementEnvelope'
        rejection_reason:
          anyOf:
          - type: string
          - type: 'null'
          title: Rejection Reason
      type: object
      required:
      - transfer_id
      - status
      - submitted_at
      - settled_at
      - wall_clock_ms
      - off_chain_ms
      - on_chain_ms
      - transfer
      - compliance_bundle
      - settlement_envelope
      title: TransferResponse
    ComplianceEnvelopeSummary:
      properties:
        control_id:
          type: string
          title: Control Id
        auditor:
          type: string
          title: Auditor
        pass:
          type: boolean
          title: Pass
        score:
          type: number
          title: Score
        sha3_256:
          type: string
          title: Sha3 256
        ed25519_signature:
          type: string
          title: Ed25519 Signature
        mldsa65_signature:
          type: string
          title: Mldsa65 Signature
        duration_ms:
          type: number
          title: Duration Ms
      type: object
      required:
      - control_id
      - auditor
      - pass
      - score
      - sha3_256
      - ed25519_signature
      - mldsa65_signature
      - duration_ms
      title: ComplianceEnvelopeSummary
    ComplianceBundle:
      properties:
        controls_audited:
          type: integer
          title: Controls Audited
        all_passed:
          type: boolean
          title: All Passed
        score:
          type: number
          title: Score
        envelopes:
          items:
            $ref: '#/components/schemas/ComplianceEnvelopeSummary'
          type: array
          title: Envelopes
      type: object
      required:
      - controls_audited
      - all_passed
      - score
      - envelopes
      title: ComplianceBundle
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    TransferRequest:
      properties:
        from_did:
          type: string
          title: From Did
          description: Sender DID, e.g. did:hive:treasury:0x...
        to_did:
          type: string
          title: To Did
          description: Recipient DID
        asset:
          type: string
          title: Asset
          description: Asset symbol (USDC / USDT / EURC / PYUSD)
        chain:
          type: string
          title: Chain
          description: Settlement chain
          default: base-8453
        amount:
          type: string
          title: Amount
          description: Amount as decimal string, e.g. '100000.00'
        purpose:
          type: string
          maxLength: 64
          title: Purpose
          default: trade-settlement
        jurisdiction_pair:
          items:
            type: string
          type: array
          title: Jurisdiction Pair
        compliance_controls:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Compliance Controls
          description: Override default 4 controls. None means use defaults.
        memo:
          anyOf:
          - type: string
            maxLength: 256
          - type: 'null'
          title: Memo
        sphere_override:
          anyOf:
          - type: string
          - type: 'null'
          title: Sphere Override
          description: Force a specific Sphere tier; otherwise auto-selected by amount.
      type: object
      required:
      - from_did
      - to_did
      - asset
      - amount
      title: TransferRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SettlementEnvelope:
      properties:
        sha3_256:
          type: string
          title: Sha3 256
        ed25519_signature:
          type: string
          title: Ed25519 Signature
        mldsa65_signature:
          type: string
          title: Mldsa65 Signature
        sphere_tier:
          type: string
          title: Sphere Tier
        sphere_cost_usd:
          type: number
          title: Sphere Cost Usd
        anchor_tx:
          anyOf:
          - type: string
          - type: 'null'
          title: Anchor Tx
        anchor_chain:
          type: string
          title: Anchor Chain
        verifier_url:
          type: string
          title: Verifier Url
      type: object
      required:
      - sha3_256
      - ed25519_signature
      - mldsa65_signature
      - sphere_tier
      - sphere_cost_usd
      - anchor_chain
      - verifier_url
      title: SettlementEnvelope
x-provenance:
  method: harvested
  publisher: Hive Civilization
  source: https://receipts.thehiveryiq.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)