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/hiro-atlas-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

openapi: 3.2.0
info:
  title: Stacks 3.0+ RPC Atlas API
  version: 1.0.0
  description: 'This is the documentation for the `stacks-node` RPC interface.

    '
  license:
    name: CC-0
    url: https://creativecommons.org/publicdomain/zero/1.0/
servers:
- url: http://localhost:20443
  description: Local Stacks Node
tags:
- name: Atlas
  description: Operations related to the Atlas global namespace.
paths:
  /v2/attachments/{hash}:
    get:
      summary: Get attachment by hash
      tags:
      - Atlas
      security: []
      operationId: getAttachment
      description: 'Get an attachment by its hash. Attachments are content stored in the Atlas network.


        The attachment hash is a 40-character hex string (SHA-1 hash).

        '
      parameters:
      - name: hash
        in: path
        required: true
        description: Hex-encoded SHA-1 hash of the attachment (40 characters)
        schema:
          type: string
          pattern: ^[0-9a-f]{40}$
      responses:
        '200':
          description: The attachment content
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AttachmentData'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
  /v2/attachments/inv:
    get:
      summary: Get attachment inventory
      tags:
      - Atlas
      security: []
      operationId: getAttachmentsInventory
      description: 'Get inventory of attachments for a given index block hash and page range.

        This returns a bitfield indicating which attachments are available.

        '
      parameters:
      - name: index_block_hash
        in: query
        required: true
        description: Hex-encoded index block hash (64 characters)
        schema:
          type: string
          pattern: ^[0-9a-f]{64}$
      - name: pages_indexes
        in: query
        required: true
        description: 'Comma-separated list of page indexes to query.

          - Maximum 8 pages per request

          - Each index must be 0-4294967295 (u32 range)

          - Values outside u32 range return 400 Bad Request

          '
        schema:
          type: string
          example: 1,2,3
          pattern: ^[0-9]{1,10}(,[0-9]{1,10}){0,7}$
      responses:
        '200':
          description: Attachment inventory bitfield
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AttachmentInventory'
              examples:
                attachment-inventory:
                  summary: Attachment inventory response
                  value:
                    block_id: 0123456789abcdef0123456789abcdef0123456789abcdef
                    pages:
                    - index: 1
                      inventory:
                      - 255
                      - 0
                      - 255
                      - 0
                    - index: 2
                      inventory:
                      - 0
                      - 255
                      - 0
                      - 255
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  schemas:
    AttachmentData:
      $ref: ./components/schemas/attachment-data.schema.yaml
    AttachmentInventory:
      $ref: ./components/schemas/attachment-inventory.schema.yaml
  responses:
    NotFound:
      description: Not found
      content:
        text/plain:
          schema:
            type: string
          example: Not found
    BadRequest:
      description: Bad request
      content:
        text/plain:
          schema:
            type: string
          example: Bad request
  securitySchemes:
    rpcAuth:
      type: apiKey
      in: header
      name: authorization
      description: 'Plain-text secret value that must exactly equal the node''s

        configured password, which is set as `connection_options.auth_token`

        in the node''s configuration file.

        '