# OnChain Music

> OnChain Music is a music licensing, distribution, and blockchain royalty platform for independent artists. It offers a catalog of over 5,000 unique, licensable tracks across all genres, with transparent on-chain royalty payments to artists.

## Platform

OnChain Music (onchainmusic.com) serves two primary audiences:

- **Artists & Labels**: Upload, distribute, and monetize music across streaming platforms and sync licensing opportunities. Royalties are tracked and paid transparently on-chain.
- **Content Creators & Licensees**: Search and license music for use in video, film, games, podcasts, advertising, and digital media.

## Music Catalog

The OnChain Music catalog contains over 5,000 tracks spanning genres including:
- Electronic, ambient, cinematic, hip-hop, indie, rock, pop, folk, jazz, and more
- Tracks are available in full-quality WAV, AIF, and MP3 formats
- All tracks are independently owned and cleared for licensing — no major label conflicts
- Metadata includes genre, subgenre, mood, tempo, BPM, key, instrumentation, vocal/instrumental, keywords, and description

## Licensing

OnChain Music offers music licensing for the following use types:

- **Social Media License** ($5.00 USDC): Covers use on TikTok, Instagram, YouTube, X, and similar platforms for non-commercial creator content
- **All Digital License** ($35.00 USDC): Covers commercial use including advertising, apps, games, podcasts, websites, and digital media globally

All licenses are perpetual, non-exclusive, and cleared worldwide. License terms are machine-readable and available via API.

## Agentic Licensing

OnChain Music supports the x402 payment protocol, enabling AI agents to autonomously search the catalog, select tracks, and execute licenses paid in USDC on Base with no human in the loop.

The agentic licensing flow:
1. Agent queries GET /api/v1/agent/catalog/search with filters (genre, mood, BPM, instrumental, etc.)
2. Agent selects a track and POSTs to /api/v1/agent/license/{track_id}/{license_type} with its paying_wallet address
3. Server returns 402 with payment instructions — amount, receiving address, and chain details
4. Agent sends USDC on Base from its declared wallet — no memo or calldata required
5. Agent polls GET /api/v1/agent/license/verify/{payment_id}
6. Server detects on-chain payment and returns a signed license document with download URLs

Payment is verified on-chain via wallet address matching. Licenses are issued automatically upon payment confirmation. Artists are paid transparently with a full payee audit trail on every license.

OnChain Music is designed to be the music licensing layer of the agentic web.

## API

Base URL: https://onchainmusic.com/api/v1/agent
Discovery: https://onchainmusic.com/.well-known/agent.json

## API Documentation
Full Agent API documentation: https://onchainmusic.com/api-docs

### Endpoints

**GET /api/v1/agent/catalog/search**
Search the catalog. Parameters: genre, subgenre, additional, tempo, bpm_min, bpm_max, key, instrumental (Yes/No), keywords, description, license_type, per_page, page.

**GET /api/v1/agent/catalog/tracks/{id}**
Retrieve full metadata and license pricing for a specific track.

**POST /api/v1/agent/license/{track_id}/{license_type}**
Initiate a license purchase. Body: { "paying_wallet": "0x..." }. Returns 402 with x402 payment details.
License types: social_media | all_digital

**POST /api/v1/agent/ai-search**
Natural language music search. Body: { "phrase": "I need an epic orchestral trailer track" }. Returns catalog results plus an ai object showing the translated search parameters.

**GET /api/v1/agent/license/verify/{payment_id}**
Poll for license status. Returns signed license document and S3 download URLs once payment is confirmed on-chain.

Note: Always use description= as the primary search field for style and mood queries. Pass descriptive words directly — the API searches each word individually across multiple fields.

## Payment

- Protocol: x402
- Chain: Base (chain_id: 8453)
- Token: USDC
- USDC Contract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- Ethereum and Solana support: planned

## Contact & Partnerships

For partnership inquiries, API access, or integration discussions:
- Website: https://onchainmusic.com
- Partnerships: https://onchainmusic.com/contact