Read-Only Public API

Band Directory API

Integrate public band metadata directly into third-party music discovery tools, fan widgets, or streaming sites. This API strictly provides public band profile information and is completely isolated from user authentication, wallet balances, or trading mechanics.

Strict Isolation & Security Guarantee

This endpoint only extracts non-sensitive, public band details (band name, genre, ticker symbol, description, and avatar). It is strictly disconnected from user accounts, payment processors, private agreements, or liquidity reserves.

GET /api/bands

Rate Limit: Public / Unlimited

Retrieves a JSON array of all active registered bands and their public profile information.

Query Parameters

Parameter	Type	Description
limit	integer (optional)	Maximum number of band records to return (e.g., `?limit=10`).

Live API Response Preview

Click "Run Live Fetch" above to query /api/bands in real-time...

JavaScript / Fetch Example

Use standard HTTP fetch() in any modern browser or Node.js environment:

// Fetch public band details
async function loadBands() {
  const response = await fetch('https://bandcoins.com/api/bands?limit=10');
  const data = await response.json();
  
  if (data.success) {
    console.log(`Retrieved ${data.count} bands:`, data.bands);
  }
}