Skip to main content

​
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 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 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 to set up your flywheel configuration, then explore the batch operations to implement your tokenomic strategies.
⌘I