Endpoints

The primary interaction with Clawmato is through the context retrieval endpoint.

GET/context

Retrieves the latest context snapshot based on provided filters.

curl -X GET "https://clawmato.xyz/api/v1/context?types=news,crypto&limit=5" \
  -H "Authorization: Bearer YOUR_KEY"
POST/augment

Accepts a raw prompt and returns it wrapped with relevant context system instructions. Useful for direct integration into OpenAI SDKs.

{
  "prompt": "Why is ETH up today?",
  "context_depth": "high",
  "focus": ["crypto", "macro"]
}
GET/status

Check the health and latency of underlying data providers.

curl -X GET "https://clawmato.xyz/api/v1/status"
GET/usage

Retrieve your current token consumption and remaining balance.

curl -X GET "https://clawmato.xyz/api/v1/usage" \
  -H "Authorization: Bearer YOUR_KEY"
POST/webhook

Register a webhook to receive push notifications for specific market events (e.g., "BTC > 100k").

{
  "event": "price_alert",
  "condition": "BTC > 100000",
  "callback_url": "https://api.yoursite.com/hooks/clawmato"
}