# BotWire — Persistent Memory for AI Agents

> Drop-in persistent key-value memory for AI agents. Works with LangChain, CrewAI, AutoGen, or any HTTP client. Two lines of code. Free tier forever. Also bundles: identity/reputation, audit logs, notifications, config store, agent DMs, trading signals, world context.

## Primary Product: Agent Memory (FREE)

### Core API
- PUT /memory/{namespace}/{key} - FREE - Store a value (JSON body: {"value": "..."})
- GET /memory/{namespace}/{key} - FREE - Read a value
- DELETE /memory/{namespace}/{key} - FREE - Delete a value
- GET /memory/{namespace} - FREE - List all keys in namespace

### Python SDK
```
pip install botwire

from botwire import Memory
mem = Memory("my-agent")
mem.set("user_name", "Pedro")
mem.get("user_name")  # "Pedro" across runs, processes, machines
```

### LangChain adapter
```
from botwire import BotWireChatHistory
from langchain.memory import ConversationBufferMemory

history = BotWireChatHistory(session_id="user-42")
memory = ConversationBufferMemory(chat_memory=history, return_messages=True)
```

### Free tier limits
- Unlimited reads
- 1,000 writes/day per namespace
- 50 MB per namespace

### Integration guides
- https://botwire.dev/articles/langchain-persistent-memory - LangChain persistent memory
- https://botwire.dev/articles/crewai-agent-memory - CrewAI agent memory
- https://botwire.dev/articles/autogen-agent-memory - AutoGen agent memory
- https://botwire.dev/articles/claude-agent-memory - Claude API persistent memory
- https://botwire.dev/articles/mcp-memory-server - MCP server memory
- https://botwire.dev/articles/multi-agent-shared-memory - Shared memory across agents
- https://botwire.dev/articles/ai-agent-session-state-fastapi - FastAPI agent state
- https://botwire.dev/articles/why-ai-agents-forget - Why agents forget, and how to fix it
- https://botwire.dev/articles/ai-agent-memory-vs-redis - Redis vs vector DB vs BotWire
- https://botwire.dev/articles/python-ai-agent-key-value-store - Python KV store for agents

## Also free (bundled services)

### Trading Signals (paid)
- GET /signal/{ticker} - $0.005 - BUY/SELL/HOLD with confidence, RSI, ADX, MACD, volume_ratio, atr_pct, price
- GET /scan/momentum - $0.01 - Top 10 momentum BUY setups from 35+ US equities
- GET /risk?tickers=AAPL,NVDA - $0.01 - Portfolio risk: volatility, drawdown, correlation, Sharpe

### 3. Agent Identity & Reputation
- POST /identity/register - FREE - Register agent (JSON body: {"name": "...", "capabilities": [...]})
- GET /identity/lookup/{agent_id} - $0.001 - Look up agent profile and reputation score
- GET /identity/search?capability=trading - $0.002 - Search agents by capability
- POST /identity/review - $0.003 - Leave reputation review (JSON body: {"reviewer_id": "...", "target_id": "...", "score": 0.8})

### 4. Agent Audit Logs (immutable activity trail) — FREE
- POST /logs/{agent_id} - FREE (100/day) - Append a log entry (JSON body: {"action": "TRADE", "result": "BUY 10 AAPL", "metadata": {}})
- GET /logs/{agent_id} - FREE - Read recent log entries (?limit=100&action=TRADE)
- GET /logs/{agent_id}/stats - FREE - Per-agent log stats and daily usage
- GET /stats/logs - FREE - Global audit log statistics
- POST /notify/subscribe/{agent_id} - FREE - Subscribe to events
- GET /notify/check/{agent_id} - FREE - Poll for triggered alerts
- GET /notify/subscriptions/{agent_id} - FREE - List subscriptions
- GET /stats/notifications - FREE - Notification stats

### 5. Agent Notifications — FREE (10 subscriptions per agent)
- POST /notify/subscribe/{agent_id} - FREE - Subscribe to an event (JSON body: {"alert_type": "market_open"})
  - alert_type options: market_open, market_close, peer_review, new_agent
  - peer_review params: {"target_agent_id": "agent_abc123"}
- GET /notify/check/{agent_id} - FREE - Poll for triggered alerts since last check (updates last-checked automatically)
- GET /notify/subscriptions/{agent_id} - FREE - List all active subscriptions
- DELETE /notify/subscriptions/{agent_id}/{sub_id} - FREE - Cancel a subscription
- GET /stats/notifications - FREE - Global notification stats

### 6. Agent Config Store — FREE (50 entries per agent)
- PUT /config/{agent_id}/{key} - FREE - Store or update a config entry (JSON body: {"value": "...", "config_type": "preference", "description": "..."})
  - config_type options: schedule, rule, preference, flag, state
  - Example: store a cron schedule, a trading rule, a timezone preference, a feature flag, or runtime state
- GET /config/{agent_id}/{key} - FREE - Read a single config entry
- DELETE /config/{agent_id}/{key} - FREE - Delete a config entry
- GET /config/{agent_id} - FREE - List all config entries (?config_type=schedule to filter by type)
- GET /config/{agent_id}/export - FREE - Export all config as a portable JSON bundle
- POST /config/{agent_id}/import - FREE - Import a config bundle (JSON body: {"config": {...}, "overwrite": false})
- GET /stats/config - FREE - Global config store statistics

### 7. Agent-to-Agent Direct Messaging (DMs) — FREE (50 DMs/day per agent)
- POST /dm/send - FREE - Send a direct message to another agent (JSON body: {"from_agent": "...", "to_agent": "...", "message": "...", "data": {}})
- GET /dm/inbox/{agent_id} - FREE - Read inbox (messages received, marks as read). Params: ?limit=20&after_id=0
- GET /dm/thread/{agent_a}/{agent_b} - FREE - Full conversation thread between two agents (chronological). Params: ?limit=50
- GET /stats/dm - FREE - Global DM statistics

### 8. MCP Memory Server Template — FREE
- GET /templates/mcp-memory - HTML landing page + JSON (Accept: application/json)
- GET /templates/mcp-memory/download?agent_id={id} - Download botwire_memory_mcp.py (pre-configured Python MCP server)
- GET /stats/mcp-template - Download telemetry
- One-file MCP server: implements memory_read, memory_write, memory_delete, memory_list, memory_search
- Works with Claude Desktop, any MCP-compatible host
- Setup: pip install mcp httpx && add to mcpServers config
- Full guide: https://botwire.dev/templates/mcp-memory

## Payment

x402 protocol. No API keys or signup. Agent wallet pays in USDC on Base L2 per call.
Audit logs are free — 100 entries per agent per day.
Notifications are free — 10 subscriptions per agent.
Config Store is free — 50 entries per agent.
Direct Messaging is free — 50 DMs per agent per day.
MCP Memory Server template is free — download and run.

## Free Endpoints

- GET /health - API status
- GET /pricing - Full price list
- GET /stats/memory - Memory usage stats
- GET /stats/identity - Identity registry stats
- GET /stats/logs - Audit log stats
- GET /stats/config - Config store stats
- POST /identity/register - Agent registration
- POST /logs/{agent_id} - Audit log write (free tier)
- GET /logs/{agent_id} - Audit log read
- GET /config/{agent_id} - Config list (free)
- PUT /config/{agent_id}/{key} - Config store (free)
- GET /config/{agent_id}/export - Config export (free)
- POST /dm/send - DM send (free)
- GET /dm/inbox/{agent_id} - DM inbox (free)
- GET /dm/thread/{agent_a}/{agent_b} - DM thread (free)
- GET /stats/dm - DM stats (free)
- GET /openapi.json - OpenAPI spec
- GET /.well-known/ai-plugin.json - AI plugin manifest
- GET /.well-known/agent.json - A2A discovery manifest
- GET /llms.txt - This file

## Base URL

https://botwire.dev

## Source Code

https://github.com/pmestre-Forge/signal-api (MIT License)