> ## Documentation Index
> Fetch the complete documentation index at: https://docs.believe.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> API Documentation for Believe API v2

## Welcome to the Believe API

The Believe API enables projects to create self-reinforcing tokenomic cycles where specific triggers lead to positive developments, creating powerful feedback loops. Our highly configurable flywheel mechanics give projects complete control over their tokenomics and coin utilities.

## Flywheel Mechanics

### Core Concept

A flywheel is a self-reinforcing cycle where certain triggers or developments in a crypto project lead to further positive developments, creating a positive feedback loop. The Believe Flywheel API can be triggered by projects over pre-configured events, with base coins powering API invocations.

### Security Architecture

**Multi-Signature Protection**: Base coins are secured within a multisignature wallet requiring signatures from both:

* Believe's approver wallet
* Your project's approver wallet

This dual-approval mechanism prevents exploitation of flywheel actions and ensures secure coin operations.

**Daily Limits**: Configurable daily maximum caps regulate the amount of base coins impacted by flywheel actions, providing additional protection against misuse.

**Public Transparency**: The vault address is publicly exposed, allowing community participation in powering your project's flywheel, creating a "Plug-N-Play" experience where participants can contribute base coins to the flywheel wallet.

## Flywheel Components

### Actions

Individual operations that can be executed using base coins:

* **Burn**: Permanently remove coins from circulation
* **Airdrop**: Distribute coins to specified addresses
* **Buyback** *(Coming Soon)*: Repurchase coins from the market
* **Lock** *(Coming Soon)*: Secure coins with vesting parameters
* **Unlock** *(Coming Soon)*: Release previously locked coins
* **Memo**: Attach proof data to transactions

### Batched Actions

Execute multiple actions of the same type together as a single batch operation for efficiency and cost optimization.

### Pipelines

Chain multiple different actions together (e.g., Buyback → Burn → Airdrop) in a single atomic operation, enabling sophisticated tokenomic strategies.

### State Machines *(Coming Soon)*

Create interconnected pipelines with conditional logic to build complex, automated tokenomic systems triggered by your API invocations.

### Proof Mechanism

Every flywheel action includes a memo containing JSON proof data from your application, providing:

* **Auditability**: Complete transaction history with context
* **Transparency**: On-chain verification of action intentions
* **Compliance**: Detailed records for regulatory requirements

## API Workflow

1. **Register**: Set up your flywheel via the [Believe web app](https://believe.app/projects) with token details, wallet addresses, daily limits, and proof schemas
2. **Initialize**: Create batch transactions with your desired pipeline actions
3. **Approve**: Sign the proposal transaction with your registered wallet
4. **Execute**: Process the approved batch and receive detailed execution results
5. **Monitor**: Track batch status and retrieve transaction details

## Authentication

**Base URL**: `https://public.believe.app/v1/`

Generate your API key at [believe.app/projects](https://believe.app/projects) after creating a project. Include it in all requests using the `x-believe-api-key` header.

## Getting Started

Begin by registering your flywheel via the [Believe Web App](https://believe.app/projects) to set up your flywheel configuration, then explore the batch operations to implement your tokenomic strategies.