​
Welcome

The Bags API provides comprehensive functionality for managing API keys and launching tokens on the Solana blockchain. This reference documents all available endpoints with detailed examples.

​
Base URL

All API endpoints use the following base URL: 
https://public-api-v2.bags.fm/api/v1/

​
Authentication

The Bags API uses API key authentication with Bearer token format. Include your API key in the Authorization header: 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://public-api-v2.bags.fm/api/v1/endpoint
Required for all endpoints except public analytics endpoints. Get your API key from the Bags Developer Dashboard.

​
Public Key Format

Throughout this documentation, when we refer to “public key” we always mean Base58 encoded public keys. This is the standard format used by Solana for representing wallet addresses, token mints, and other on-chain accounts.

​
Response Format

All API responses follow a consistent format: Success Response: 
{
  "success": true,
  "response": {
    // Response data here
  }
}
Error Response: 
{
  "success": false,
  "error": "Error message description"
}

​
Available Endpoints

The API provides the following functionality:
  • Token Launch: Create and manage token launches with metadata and initial purchases
  • Fee Sharing: Configure custom fee sharing between wallets
  • Analytics: Retrieve token lifetime fees and creator information
  • Fee Claiming: Generate transactions to claim fees from various sources
All endpoints are documented below with request/response schemas, parameters, and examples.