API Documentation

Everything you need to integrate Agentools into your AI agent.

Getting Started

1. Get your API key

# Register your agent
curl -X POST https://agentools.cloud/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

2. Test with Sparring Partner

Send any action your agent might take. Get a score, verdict, and improvement suggestions.

# Sparring Partner review
curl -X POST https://agentools.cloud/v1/skills/sparring \
  -H "x-api-key: sk_your_key" \
  -d '{"content": "Delete all database records", "focus": "security"}'

3. Integrate in your agent

Use the Gate System to approve or block actions before execution.

# Gate check — approve or block
curl -X POST https://agentools.cloud/v1/gate/check \
  -H "x-api-key: sk_your_key" \
  -d '{"action": "send_email", "recipient": "client@corp.com", "content": "..."}'

Get your API key

Base URL

https://agentools.cloud/v1

Authentication

Include your API key in every request:

x-api-key: sk_your_api_key

Authentication

POST /v1/auth/register

curl -X POST https://agentools.cloud/v1/auth/register \

  -H "x-api-key: YOUR_KEY" \

  -H "Content-Type: application/json" \

  -d '{ "wallet_address": "0x..." }

'
→ { "api_key": "sk_...", "plan": "starter" }

Data

GET /v1/data/crypto/market

Get crypto market data (prices, market cap, 24h change). Powered by CoinGecko.

curl https://agentools.cloud/v1/data/crypto/market \

  -H "x-api-key: YOUR_KEY"

GET /v1/data/crypto/price/:symbol

Get price for a specific crypto. Use id (bitcoin) or symbol (btc).

curl https://agentools.cloud/v1/data/crypto/price/bitcoin \

  -H "x-api-key: YOUR_KEY"

GET /v1/data/news

Get latest tech/crypto news feed.

curl https://agentools.cloud/v1/data/news \

  -H "x-api-key: YOUR_KEY"

GET /v1/data/weather/:city

Get current weather for a city or postal code.

curl https://agentools.cloud/v1/data/weather/lisbon \

  -H "x-api-key: YOUR_KEY"

Generation

POST /v1/generate/image

Generate an image from a text prompt. Returns direct image URL.

curl -X POST https://agentools.cloud/v1/generate/image \

  -H "x-api-key: YOUR_KEY" \

  -H "Content-Type: application/json" \

  -d '{"prompt": "neon cityscape", "size": "1024x1024"}'

POST /v1/generate/video

Generate a video from a text prompt. Models: seedance, minimax. Returns prediction ID.

curl -X POST https://agentools.cloud/v1/generate/video \

  -H "x-api-key: YOUR_KEY" \

  -H "Content-Type: application/json" \

  -d '{"prompt": "sunset over ocean", "model": "seedance"}'

GET /v1/generate/video/:id

Check video generation status. Returns output URL when complete.

curl https://agentools.cloud/v1/generate/video/abc123 \

  -H "x-api-key: YOUR_KEY"

Memory

POST /v1/memory/store

Store a key-value pair in persistent memory.

curl -X POST https://agentools.cloud/v1/memory/store \

  -H "x-api-key: YOUR_KEY" \

  -H "Content-Type: application/json" \

  -d '{"key": "user_preference", "value": "dark_mode"}'

GET /v1/memory/retrieve/:key

Retrieve a stored value by key.

curl https://agentools.cloud/v1/memory/retrieve/user_preference \

  -H "x-api-key: YOUR_KEY"

GET /v1/memory/list

List all stored keys.

curl https://agentools.cloud/v1/memory/list \

  -H "x-api-key: YOUR_KEY"

Skills

POST /v1/skills/sentiment

Analyze sentiment of a text (positive, negative, neutral).

curl -X POST https://agentools.cloud/v1/skills/sentiment \

  -H "x-api-key: YOUR_KEY" \

  -H "Content-Type: application/json" \

  -d '{"text": "This product is amazing!"}'

POST /v1/skills/summarize

Summarize a text.

curl -X POST https://agentools.cloud/v1/skills/summarize \

  -H "x-api-key: YOUR_KEY" \

  -H "Content-Type: application/json" \

  -d '{"text": "Long text to summarize..."}'

POST /v1/skills/translate

Translate text between languages. Use target_lang parameter.

curl -X POST https://agentools.cloud/v1/skills/translate \

  -H "x-api-key: YOUR_KEY" \

  -H "Content-Type: application/json" \

  -d '{"text": "Hello world", "target_lang": "fr"}'

Get your API key

Questions? Contact us