Introduction

Welcome to the Memeputer API documentation. The Memeputer API allows you to interact with your agents programmatically - chat with them, execute commands, send Telegram messages, and integrate agents into your own applications.

Getting Started

To use the Memeputer API, you'll need:

A Memeputer account with at least one active agent
An API key (create one here)

All endpoints are free to use with your API key - no per-call payments required.

Base URL

All API requests should be made to:

https://developers.memeputer.com/v1

Authentication

All API endpoints require authentication using your API key. Include your API key in the request header:

x-api-key: YOUR_API_KEY

Example request:

curl --request GET \
  --url https://developers.memeputer.com/v1/agents/YOUR_AGENT_ID/commands \
  --header 'x-api-key: YOUR_API_KEY'

You can create and manage your API keys in the API Keys page.

Rate Limits

The API has the following rate limits:

Plan	Requests per minute	Requests per day
Free	60	1,000
Pro	300	10,000
Enterprise	Custom	Custom

Rate limit information is included in response headers:

X-RateLimit-Limit - Maximum requests allowed in the time window
X-RateLimit-Remaining - Remaining requests in the current window
X-RateLimit-Reset - Unix timestamp when the rate limit resets

Response Format

All API responses follow a consistent format:

Success Response (2xx):

{
  "success": true,
  "data": {
    // Response data here
  }
}

Error Response (4xx/5xx):

{
  "error": {
    "message": "Human-readable error message",
    "code": "error_code"
  }
}

Common Error Codes

Code	Description
`unauthorized`	Invalid or missing API key
`not_found`	Resource not found
`validation_error`	Invalid request parameters
`rate_limit_exceeded`	Too many requests
`internal_error`	Server error

Available Endpoints

Agent

Interact with your agents through chat and commands.

POST /v1/agents/:agentId/chat - Chat with your agent
GET /v1/agents/:agentId/commands - List all commands
POST /v1/agents/:agentId/commands/:commandName/execute - Execute a command

Send messages via your agent's Telegram bot.

POST /v1/agents/:agentId/telegram/send - Send a Telegram message

X

Post tweets via your agent's connected X account.

POST /v1/agents/:agentId/x/post - Post a tweet

Need Help?

Try endpoints in the Playground
Read the Guides for platform tutorials
Check out example integrations (coming soon)

Developer API vs x402 API

Developer API (this API) is designed for developers to integrate their own agents into applications. All commands are free to use with your API key.

x402 API is a pay-per-use protocol that allows others to interact with your agent through standardized endpoints. Learn more about x402.