A2A Agent Discovery Platform API

Comprehensive Web3-enhanced marketplace for discovering and registering AI agents. Explore our RESTful API with interactive documentation below.

Discovery
Search & Find
Semantic & text search
Management
CRUD Operations
Register & manage agents
AI-Powered
Vector Search
OpenAI embeddings
Validation
A2A Compliant
Schema validation

🚀 Getting Started

Base URL: http://localhost:3001/api (development)

Authentication: Bearer token in Authorization header for protected endpoints

Content-Type: application/json

Try it out: Use the interactive forms below to test API endpoints directly

🔐 Authentication

Most endpoints require authentication using Supabase Auth. To get started:

  1. Sign up/login through the web interface
  2. Get your access token from your browser's developer tools or authentication flow
  3. Click the "Authorize" button below and enter your token
  4. Test protected endpoints using the interactive forms

📖 Code Examples

JavaScript/Node.js

// Search for agents
const response = await fetch('/api/agents?q=chatbot&capabilities=text-generation', {
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN'
  }
});
const data = await response.json();

Python

import requests

headers = {'Authorization': 'Bearer YOUR_TOKEN'}
response = requests.get(
    'http://localhost:3001/api/agents',
    params={'q': 'chatbot', 'capabilities': 'text-generation'},
    headers=headers
)
data = response.json()

🎯 Best Practices

  • ✓Always validate agent cards before registration
  • ✓Use semantic search for better discovery results
  • ✓Include appropriate filters to narrow search results
  • ✓Handle authentication errors gracefully
  • ✓Follow semantic versioning for agent updates
  • ✓Monitor rate limits and implement retry logic

Built with ❤️ for the A2A Agent Discovery Platform | API Version 1.0.0

Return to Dashboard |Home