Skip to main content

​
Data Sources

Unified data layer for autonomous music agents. Agentbot agents read, write, and act on data from databases, blockchains, AI models, and external APIs — all through a single integration surface.

​
Overview

Every agent needs data. Agentbot provides a layered data architecture — from local storage to onchain reads — so your agents can query, persist, and act on real-time information without custom plumbing.

​
Source Categories

​
Databases

SourcePurposeAccess
PostgreSQL (Neon)User data, agent config, workflows, billingDATABASE_URL env var
RedisCaching, rate limiting, session stateREDIS_URL env var
BlockDBMusic metadata, audio components, rightsBlockDB docs

​
Blockchain

SourceChainUse Case
Base MainnetEthereum L2Token balances, NFT ownership, USDC
Base SepoliaTestnetDevelopment and staging
CDP WalletsBaseAgent treasury, payments, swaps

​
AI Providers (BYOK)

ProviderModelsNotes
OpenRouter300+ modelsDefault provider, widest selection
AnthropicClaude 3.5/OpusStrong reasoning, long context
OpenAIGPT-4o/o3Vision, function calling
GoogleGemini 2.0Multimodal, fast inference
GroqLlama 3, MixtralUltra-fast inference, lowest latency
All providers are Bring Your Own Key — no markup on API costs.

​
External APIs

ServiceCapability
Music Lens APIMood analysis, tempo detection, key identification
WeatherCurrent conditions and forecasts
Web SearchReal-time web search for agent queries
Base FMOnchain radio submission queue
NotionSync databases, pages, workflows
Browser AutomationAutonomous web scraping and form filling
ClawMerchants15 live data feeds — DeFi yields, token anomalies, security intel, market data, and more (API reference)

​
Payments

ProviderTypeData Available
StripeCredit cardSubscriptions, invoices, credit balances
x402USDC (Base)Onchain payment receipts
MPPCrypto (Tempo)Decentralized payment records

​
Configuration

Set data source credentials in your .env: 
# Database
DATABASE_URL=postgresql://user:pass@host:5432/agentbot
REDIS_URL=redis://localhost:6379

# AI Providers (at least one required)
OPENROUTER_API_KEY=sk-or-...
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...

# Blockchain
CDP_API_KEY_NAME=your-key-name
CDP_API_KEY_PRIVATE_KEY=your-private-key

​
Architecture

┌─────────────────────────────────────────────┐
│               AGENT CONTAINER               │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  │
│  │  Memory  │  │  Skills  │  │  A2A Bus │  │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  │
└───────┼──────────────┼─────────────┼────────┘
        │              │             │
   ┌────▼──────────────▼─────────────▼────┐
   │        DATA SOURCE LAYER             │
   │                                      │
   │  ┌───────┐ ┌───────┐ ┌───────────┐  │
   │  │  PG   │ │ Redis │ │Blockchain │  │
   │  │(Neon) │ │       │ │  (Base)   │  │
   │  └───────┘ └───────┘ └───────────┘  │
   │                                      │
   │  ┌───────┐ ┌───────┐ ┌───────────┐  │
   │  │AI APIs│ │BlockDB│ │  External │  │
   │  │(BYOK) │ │       │ │  (Skills) │  │
   │  └───────┘ └───────┘ └───────────┘  │
   └──────────────────────────────────────┘

​
Data Isolation

Multi-tenant deployments enforce strict data boundaries:
  • Each user’s agent data is isolated via userId scoping
  • Database queries filter by authenticated session
  • BlockDB queries include creator attribution
  • Blockchain reads are per-wallet (no shared state)