AnchorRegistry

AnchorRegistry Account API

The account API from AnchorRegistry — 5 operation(s) for account.

GitHub OpenAPI

Operations 5

POST /register/account Register Account #
POST /register/account/topup Topup Account #
POST /register/x402 Register With Account #
GET /account/{anchor_key}/balance Get Account Balance #
GET /account/{anchor_key}/tree Get Account Tree #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/anchorregistry-ai/openapi/anchorregistry-ai-account-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/anchorregistry-ai/json-schema/anchorregistry-ai-pending-registration-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/anchorregistry-ai/json-schema/anchorregistry-ai-account-registration-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/anchorregistry-ai/json-schema/anchorregistry-ai-status-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/anchorregistry-ai/json-schema/anchorregistry-ai-tree-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/anchorregistry-ai/json-schema/anchorregistry-ai-retraction-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/anchorregistry-ai/json-schema/anchorregistry-ai-account-request-schema.json

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/anchorregistry-ai/apis.yml

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/anchorregistry-ai:anchorregistry-ai-account-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.

GitHub Google LinkedIn

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

OpenAPI Specification

anchorregistry-ai-account-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: AnchorRegistry Account API
  version: 1.0.0
tags:
- name: Account
paths:
  /register/account:
    post:
      tags:
      - Account
      summary: Register Account
      description: 'Buy an ACCOUNT anchor. Payment verification is handled by the x402 SDK

        middleware (see app/main.py); by the time this handler runs, the payment

        has cleared the facilitator and the matched requirements are on

        request.state.'
      operationId: register_account_register_account_post
      requestBody:
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/AccountRequest'
              title: Body
              default:
                capacity_tier: starter
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '402':
          description: Payment Required
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '50'
        protocols:
        - x402: {}
      extensions:
        bazaar:
          info:
            input:
              capacity_tier: starter
            output:
              ar_id: AR-2026-XXXXXXX
              anchor_key: a3f8c2e1...
              capacity: 50
              tier: starter
              tx_hash: 0x1234567890abcdef...
              block_number: 12345678
              rail: x402
              status: confirmed
              verify_url: https://anchorregistry.ai/AR-2026-XXXXXXX
          schema:
            type: object
            properties:
              input:
                type: object
                properties:
                  capacity_tier:
                    type: string
                    enum:
                    - starter
                    - builder
                    description: starter ($50 / 50 anchors) or builder ($100 / 200 anchors)
                required:
                - capacity_tier
              output:
                type: object
                properties:
                  ar_id:
                    type: string
                  anchor_key:
                    type: string
                  capacity:
                    type: integer
                  tier:
                    type: string
                  tx_hash:
                    type: string
                  block_number:
                    type: integer
                  rail:
                    type: string
                  status:
                    type: string
                  verify_url:
                    type: string
      x-input-schema:
        type: object
        properties:
          capacity_tier:
            type: string
            enum:
            - starter
            - builder
            default: starter
            description: starter ($50 / 50 anchors) or builder ($100 / 200 anchors)
          parent_ar_id:
            type: string
            description: Optional parent AR-ID
          wallet_address:
            type: string
            description: Required when ToS enforcement is enabled
          tos_signature:
            type: string
            description: Wallet signature over the ToS consent message
        required: []
      x-output-schema:
        type: object
        properties:
          ar_id:
            type: string
          anchor_key:
            type: string
            description: Bearer key for subsequent artifact registration — shown ONCE
          capacity:
            type: integer
          tier:
            type: string
            enum:
            - starter
            - builder
          tx_hash:
            type: string
          block_number:
            type: integer
          rail:
            type: string
          status:
            type: string
            enum:
            - confirmed
            - queued
          verify_url:
            type: string
  /register/account/topup:
    post:
      tags:
      - Account
      summary: Topup Account
      description: Extend an existing ACCOUNT's capacity via x402 payment.
      operationId: topup_account_register_account_topup_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TopupRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '402':
          description: Payment Required
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '50'
        protocols:
        - x402: {}
      extensions:
        bazaar:
          info:
            input:
              anchor_key: <account_anchor_key>
              capacity_tier: starter
            output:
              ar_id: AR-2026-YYYYYYY
              root_ar_id: AR-2026-XXXXXXX
              new_capacity: 50
              total_capacity: 100
              used: 3
              remaining: 97
              tx_hash: 0x1234567890abcdef...
              rail: x402
              status: confirmed
          schema:
            type: object
            properties:
              input:
                type: object
                properties:
                  anchor_key:
                    type: string
                    description: ACCOUNT anchor key
                  capacity_tier:
                    type: string
                    enum:
                    - starter
                    - builder
                required:
                - anchor_key
                - capacity_tier
              output:
                type: object
                properties:
                  ar_id:
                    type: string
                  root_ar_id:
                    type: string
                  new_capacity:
                    type: integer
                  total_capacity:
                    type: integer
                  used:
                    type: integer
                  remaining:
                    type: integer
                  tx_hash:
                    type: string
                  rail:
                    type: string
                  status:
                    type: string
      x-input-schema:
        type: object
        properties:
          anchor_key:
            type: string
            description: Anchor key of the ACCOUNT to top up
          capacity_tier:
            type: string
            enum:
            - starter
            - builder
            default: starter
            description: starter (+$50 / +50 anchors) or builder (+$100 / +200 anchors)
        required:
        - anchor_key
      x-output-schema:
        type: object
        properties:
          ar_id:
            type: string
          root_ar_id:
            type: string
          new_capacity:
            type: integer
          total_capacity:
            type: integer
          used:
            type: integer
          remaining:
            type: integer
          tx_hash:
            type: string
          rail:
            type: string
          status:
            type: string
            enum:
            - confirmed
            - queued
  /register/x402:
    post:
      tags:
      - Account
      summary: Register With Account
      description: 'Register an artifact against an ACCOUNT''s remaining capacity.

        Auth: `Authorization: Bearer `.'
      operationId: register_with_account_register_x402_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountRegistrationRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /account/{anchor_key}/balance:
    get:
      tags:
      - Account
      summary: Get Account Balance
      description: Return tree-derived ACCOUNT balance. 401 on unknown key.
      operationId: get_account_balance_account__anchor_key__balance_get
      parameters:
      - name: anchor_key
        in: path
        required: true
        schema:
          type: string
          title: Anchor Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /account/{anchor_key}/tree:
    get:
      tags:
      - Account
      summary: Get Account Tree
      description: 'Return the full ACCOUNT subtree — every ACCOUNT top-up node plus every

        registered artifact under the root — along with current balance.'
      operationId: get_account_tree_account__anchor_key__tree_get
      parameters:
      - name: anchor_key
        in: path
        required: true
        schema:
          type: string
          title: Anchor Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AccountRegistrationRequest:
      properties:
        manifest_hash:
          type: string
          title: Manifest Hash
        artifact_type:
          type: string
          title: Artifact Type
        title:
          type: string
          title: Title
        author:
          type: string
          title: Author
          default: ''
        descriptor:
          type: string
          title: Descriptor
          default: ''
        parent_hash:
          type: string
          title: Parent Hash
          default: ''
        registered_at:
          type: string
          title: Registered At
          default: ''
        notes:
          type: string
          title: Notes
          default: ''
        git_hash:
          type: string
          title: Git Hash
          default: ''
        license:
          type: string
          title: License
          default: ''
        language:
          type: string
          title: Language
          default: ''
        version:
          type: string
          title: Version
          default: ''
        doi:
          type: string
          title: Doi
          default: ''
        institution:
          type: string
          title: Institution
          default: ''
        co_authors:
          type: string
          title: Co Authors
          default: ''
        data_version:
          type: string
          title: Data Version
          default: ''
        format:
          type: string
          title: Format
          default: ''
        row_count:
          type: string
          title: Row Count
          default: ''
        schema_url:
          type: string
          title: Schema Url
          default: ''
        model_version:
          type: string
          title: Model Version
          default: ''
        architecture:
          type: string
          title: Architecture
          default: ''
        parameters:
          type: string
          title: Parameters
          default: ''
        training_dataset:
          type: string
          title: Training Dataset
          default: ''
        agent_version:
          type: string
          title: Agent Version
          default: ''
        runtime:
          type: string
          title: Runtime
          default: ''
        capabilities:
          type: string
          title: Capabilities
          default: ''
        media_type:
          type: string
          title: Media Type
          default: ''
        duration:
          type: string
          title: Duration
          default: ''
        isrc:
          type: string
          title: Isrc
          default: ''
        text_type:
          type: string
          title: Text Type
          default: ''
        isbn:
          type: string
          title: Isbn
          default: ''
        publisher:
          type: string
          title: Publisher
          default: ''
        platform:
          type: string
          title: Platform
          default: ''
        description:
          type: string
          title: Description
          default: ''
        file_manifest_hash:
          type: string
          title: File Manifest Hash
          default: ''
        post_id:
          type: string
          title: Post Id
          default: ''
        post_date:
          type: string
          title: Post Date
          default: ''
        post_url:
          type: string
          title: Post Url
          default: ''
        executor:
          type: string
          title: Executor
          default: ''
        event_type:
          type: string
          title: Event Type
          default: ''
        event_date:
          type: string
          title: Event Date
          default: ''
        location:
          type: string
          title: Location
          default: ''
        orchestrator:
          type: string
          title: Orchestrator
          default: ''
        chain:
          type: string
          title: Chain
          default: ''
        asset_type:
          type: string
          title: Asset Type
          default: ''
        contract_address:
          type: string
          title: Contract Address
          default: ''
        tx_hash:
          type: string
          title: Tx Hash
          default: ''
        token_id:
          type: string
          title: Token Id
          default: ''
        block_number:
          type: string
          title: Block Number
          default: ''
        receipt_type:
          type: string
          title: Receipt Type
          default: ''
        merchant:
          type: string
          title: Merchant
          default: ''
        amount:
          type: string
          title: Amount
          default: ''
        currency:
          type: string
          title: Currency
          default: ''
        order_id:
          type: string
          title: Order Id
          default: ''
        receipt_url:
          type: string
          title: Receipt Url
          default: ''
        report_type:
          type: string
          title: Report Type
          default: ''
        client:
          type: string
          title: Client
          default: ''
        engagement:
          type: string
          title: Engagement
          default: ''
        authors:
          type: string
          title: Authors
          default: ''
        note_type:
          type: string
          title: Note Type
          default: ''
        date:
          type: string
          title: Date
          default: ''
        participants:
          type: string
          title: Participants
          default: ''
        kind:
          type: string
          title: Kind
          default: ''
        value:
          type: string
          title: Value
          default: ''
        url:
          type: string
          title: Url
          default: ''
      type: object
      required:
      - manifest_hash
      - artifact_type
      - title
      title: AccountRegistrationRequest
      description: 'Manifest body for /register/x402. Mirrors the consumer flow''s

        ManifestPayload, minus Stripe-tier / reservation fields.'
    TopupRequest:
      properties:
        anchor_key:
          type: string
          title: Anchor Key
        capacity_tier:
          type: string
          title: Capacity Tier
          default: starter
      type: object
      required:
      - anchor_key
      title: TopupRequest
    AccountRequest:
      properties:
        capacity_tier:
          type: string
          title: Capacity Tier
          default: starter
        parent_ar_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Parent Ar Id
        wallet_address:
          anyOf:
          - type: string
          - type: 'null'
          title: Wallet Address
        tos_signature:
          anyOf:
          - type: string
          - type: 'null'
          title: Tos Signature
      type: object
      title: AccountRequest
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError