​
API Reference Overview

The MangroveAI API is a Flask-based REST API with 60+ endpoints across 16 domains. All endpoints follow consistent patterns for authentication, error handling, and pagination.
The endpoint pages in this section are auto-generated from the live OpenAPI specification. Each endpoint page includes an interactive playground that lets you test requests directly from the docs — fill in parameters, add your Bearer token, and send a request without leaving the browser.

​
Base URL

https://api.mangrovetechnologies.ai/api/v1

​
Authentication

All endpoints (except health checks and Swagger docs) require authentication via Bearer token: 
Authorization: Bearer YOUR_TOKEN
See the Authentication guide for details on obtaining tokens.

​
Response Format

All successful responses return JSON with HTTP 200 (or 201 for creation): 
{
  "success": true,
  "data": { ... }
}

​
Error Format

All error responses follow a consistent structure: 
{
  "error": "ERROR_CODE",
  "message": "Human-readable error description",
  "code": "SPECIFIC_ERROR_CODE"
}

​
Common HTTP Status Codes

StatusMeaning
200Request successful
201Resource created
202Request accepted (async processing)
400Bad request (validation error)
401Authentication required
403Insufficient permissions
404Resource not found
409Conflict (duplicate resource)
429Rate limit exceeded
500Internal server error

​
Pagination

List endpoints support pagination with limit and offset (or skip) parameters: 
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.mangrovetechnologies.ai/api/v1/signals?limit=10&offset=0"
Response includes total count for pagination: 
{
  "signals": [...],
  "total": 136,
  "limit": 10,
  "offset": 0
}

​
Rate Limiting

Production deployments enforce rate limits. If you receive a 429 response, implement exponential backoff and retry after the specified delay.