PolySign Utility API

The utility API from PolySign — 5 operation(s) for utility.

Operations 5

GET /v1/utils/atomicnet_uid Get an AtomicNet UID.
GET /v1/utils/canonicalize Canonicalize a AtomicNet object record.
PUT /v1/data_sync/ Trigger the data synchronization.
GET /v1/data_sync/{request_id} Get the status details of sync request by its id.
GET /v1/data_sync/list Get the list of data sync requests.

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/polysign-utility-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

polysign-utility-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: The API Server as the interface to interact with AtomicNet
  license:
    name: PolySign License
    url: https://polysign.io/licenses/LICENSE-1.0
  title: AtomicNet API Server Utility API
  version: 5ba508e7771507febd8e2056c369fffd575b4272
security:
- OAuth2:
  - participant
tags:
- name: utility
paths:
  /v1/utils/atomicnet_uid:
    get:
      summary: Get an AtomicNet UID.
      tags:
      - utility
      responses:
        '200':
          description: AtomicNet UID.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AtomicNetUID'
  /v1/utils/canonicalize:
    get:
      summary: Canonicalize a AtomicNet object record.
      tags:
      - utility
      requestBody:
        description: "Requests must describe the relevant schema in the message type field.\nSupported schemas:\n  OrderRecord\n  BeneficiaryAuthRecord\n  EscrowAuthRecord\n  SettlementConfirmationRecord\n  SettlementRecord\n  AssetRecord\n  BookTransferRecord\n  BookTransferConfirmationRecord\n"
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CanonicalizeReq'
      responses:
        '200':
          description: The serialized data in json-formatted string, and it's digest.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CanonicalizeResp'
  /v1/data_sync/:
    put:
      summary: Trigger the data synchronization.
      tags:
      - utility
      requestBody:
        description: The response body.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DataSyncViewRequest'
      responses:
        '200':
          description: The response body.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataSyncViewResponse'
  /v1/data_sync/{request_id}:
    get:
      summary: Get the status details of sync request by its id.
      tags:
      - utility
      parameters:
      - name: request_id
        in: path
        description: The identifier of the data sync request.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: The requests details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataSyncStatus'
  /v1/data_sync/list:
    get:
      summary: Get the list of data sync requests.
      tags:
      - utility
      parameters:
      - name: status
        in: query
        description: The specified status to be filtered on.
        example: open
        schema:
          type: string
      responses:
        '200':
          description: A list of sync request status objects.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataSyncStatusList'
components:
  schemas:
    DataSyncOptions:
      type: object
      properties:
        priority:
          type:
          - integer
          - 'null'
          default: null
          description: The priority for the node to provide synchronization service.
        formats:
          type:
          - array
          - 'null'
          default: null
          description: The list of formats for data synchronization.
          items:
            type: string
        time_range_end:
          type:
          - string
          - 'null'
          format: date-time
          default: null
          description: The end time for data synchronization in ISO format.
        time_range_start:
          type:
          - string
          - 'null'
          format: date-time
          default: null
          description: The start time for data synchronization in ISO format.
        schema_version:
          type: integer
          default: 1
          description: Version for the message schema.
    DataSyncStatus:
      type: object
      properties:
        entities:
          type: array
          items:
            $ref: '#/components/schemas/DataSyncEntityStatus'
        sync_request:
          description: The sync request.
          allOf:
          - $ref: '#/components/schemas/DataSyncRequestStatus'
        schema_version:
          type: integer
          default: 1
          description: Version for the message schema.
      required:
      - entities
      - sync_request
    DataSyncViewResponse:
      type: object
      properties:
        request_id:
          type: string
          format: uuid
          description: The identifier for this request.
        schema_version:
          type: integer
          default: 1
          description: Version for the message schema.
      required:
      - request_id
    CanonicalizeResp:
      type: object
      properties:
        book_transfer_id:
          type:
          - string
          - 'null'
          format: uuid
          default: null
          description: The PolyNet generated book transfer ID.
        order_id:
          type:
          - string
          - 'null'
          format: uuid
          default: null
          description: The PolyNet generated order ID.
        settlement_id:
          type:
          - string
          - 'null'
          format: uuid
          default: null
          description: The PolyNet generated settlement ID.
        digest:
          type: string
          description: Digest to validate serialized_message.
        schema_version:
          type: integer
          default: 1
          description: Version for the message schema.
        serialized_message:
          type: string
          description: Serialized message for sign.
      required:
      - digest
      - serialized_message
      description: Canonicalization response object.
    DataSyncViewRequest:
      type: object
      properties:
        target_types:
          type: array
          description: The list of types to sync.
          items:
            type: string
        schema_version:
          type: integer
          default: 1
          description: Version for the message schema.
        options:
          description: The options corresponding to this request.
          allOf:
          - $ref: '#/components/schemas/DataSyncOptions'
      required:
      - options
      - target_types
    DataSyncEntityStatus:
      type: object
      properties:
        entity:
          type: string
          description: Sync target.
        status:
          type: string
          description: Sync status for this entity.
        source_node:
          type: string
          format: uuid
          description: The UUID of the data source node.
      required:
      - entity
      - source_node
      - status
    AtomicNetUID:
      type: object
      properties:
        atomicnet_uid:
          type: string
          format: uuid
          description: AtomicNet UID.
        schema_version:
          type: integer
          default: 1
          description: Version for the message schema.
      required:
      - atomicnet_uid
    DataSyncRequestStatus:
      type: object
      properties:
        request_id:
          type: string
          format: uuid
          description: The identifier for this request.
        status:
          type: string
          description: Overall sync status for this request.
        destination_node:
          type: string
          format: uuid
          description: The node's UUID who asks the sync.
        target_types:
          type: array
          description: The list of types reqeusted for sync.
          items:
            type: string
        options:
          description: The options corresponding to this request.
          allOf:
          - $ref: '#/components/schemas/DataSyncOptions'
      required:
      - destination_node
      - options
      - request_id
      - status
      - target_types
    CanonicalizeReq:
      type: object
      properties:
        schema_version:
          type: integer
          default: 1
          description: Version for the message schema.
        message_data:
          description: Data to be canonicalized.
      required:
      - message_data
      description: Canonicalization request object.
    DataSyncStatusList:
      type: object
      properties:
        requests:
          type: array
          items:
            $ref: '#/components/schemas/DataSyncRequestStatus'
      required:
      - requests
      description: List of data sync.
  securitySchemes:
    OAuth2:
      type: oauth2
      description: OAuth 2.0 with the client credentials grant flow.
      flows:
        clientCredentials:
          tokenUrl: /v1/auth/token
          scopes:
            participant: Grants access to participant.