LogoLogo
  • Welcome
  • News and updates
  • Subnet Status Update
  • Macromedia
  • Bittensor
    • DTAO
  • SUBNETS
    • Subnet 1 - Apex
      • Subnet 1: How to use APEX
      • Subnet 1: Incentive Mechanism
      • Subnet 1: Base Miner Setup
      • Subnet 1: Roadmap
    • Subnet 9 - Pre-training
      • Subnet 9: How to use Pre-training
      • Subnet 9: Incentive Mechanism
      • Subnet 9: Roadmap
    • Subnet 13 - Data Universe
      • Subnet 13: How to use Data Universe
      • Subnet 13: Incentive Mechanism
      • Subnet 13: Roadmap
      • Subnet 13 API
    • Subnet 25 - Mainframe
      • Subnet 25: How to use Mainframe
      • Subnet 25: Incentive Mechanism
      • Subnet 25: Roadmap
  • Subnet 37 - Finetuning
    • Subnet 37: How to use Fine-Tuning
    • Subnet 37: Miners
    • Subnet 37: Validators
    • Subnet 37: Incentive Mechanism
    • Subnet 37: Competitions
    • Subnet 37: Roadmap
  • CONSTELLATION - USER GUIDES
    • Apex
      • Navigating Apex
      • FAQs
    • Gravity
      • Scraping data
      • Managing and Collecting your data
      • FAQs
    • Nebula
      • Explore Nebula
      • Analyzing data
  • Developers
    • API Documentation
      • Accessing API Keys
      • SN1 - APEX
        • Endpoints
        • Example Usage
        • Agentic Tasks
        • Supported Models
      • SN13 - Data Universe
        • Endpoints
        • Example usage
        • Scraping Youtube Data
      • SN25 - Mainframe
        • API Keys
        • Folding API
          • Running Folding API Server
          • Endpoints
        • Organic API
          • Endpoints
    • Macrocosmos SDK
      • Installation
      • API Keys
      • APEX
      • Gravity
    • Tools
      • Macrocosmos MCP
      • Developer Projects
Powered by GitBook
On this page
  • Core components
  • Data Models
  1. Developers
  2. API Documentation
  3. SN25 - Mainframe

Folding API

PreviousAPI KeysNextRunning Folding API Server

Last updated 4 days ago

The Folding API provides a HTTP interface for external clients to interact with Mainframe (Subnet 25). It enables programmatic submission of protein folding jobs, querying job status, and retrieving results from the network of validators and miners that perform protein folding simulations. It is implemented using FastAPI and integrates with several core components of the subnet system.

Core components

Validator Registry

Maintains a registry of available validators on the network, tracks their status, and provides methods to select validators based on availability and stake.

Subtensor Service

Interfaces with the Bittensor blockchain to synchronize the metagraph and retrieve validator information.

Authentication System

Uses API keys for authentication and rate limiting of requests.

Request Flow

When a client submits a folding job request, the following sequence occurs:

Data Models

The API uses several core data models defined using Pydantic:

https://github.com/macrocosm-os/mainframe/blob/61136333/folding_api/schemas.py#L12-L259