Developer API

Build on CAMARON

⚠ PREVIEW — API Not Yet Live

Connect your IoT sensors, integrate market data, and leverage 13 AI functions through our RESTful API. Open ecosystem for aquaculture innovation.

IoT Webhook Ingestion

Push sensor data from any IoT device via HTTP POST with device_key authentication. Supports V1-V8 hardware.

163+ Species API

Query the full species database with optimal water params, growth curves, FCR benchmarks, and market sizes.

Tiered Auth System

Public read endpoints, API key for IoT/market data, JWT Bearer for AI modules. RBAC with 22+ roles.

Real-Time SSE Streaming

Server-Sent Events for AI responses with token-by-token rendering. Supports chat, analysis, and alerts.

Global Edge Deployment

Edge functions across 30+ regions for low-latency sensor ingestion. Multi-CDN with 99.9% uptime SLA.

Enterprise Security

Per-device rate limiting, RLS-protected data, encrypted API key rotation, and RBAC enforcement.

API Endpoints

MethodEndpointAuth
POST/api/v1/sensor-dataAPI Key
GET/api/v1/sensor-data/{device_id}API Key
POST/api/v1/devices/registerBearer
GET/api/v1/species/{id}Public
GET/api/v1/speciesPublic
POST/api/v1/disease/detectBearer
GET/api/v1/disease/protocolsPublic
GET/api/v1/market-pricesAPI Key
GET/api/v1/feed-pricesAPI Key
POST/api/v1/feed/optimizeBearer
GET/api/v1/water-standardsPublic
POST/api/v1/growth/forecastBearer
POST/api/v1/water/analyzeBearer
POST/api/v1/harvest/readinessBearer
GET/api/v1/export-regulations/{country}API Key
POST/api/v1/chatBearer
GET/api/v1/feed-recipesAPI Key
POST/api/v1/benchmarkBearer
GET/api/v1/medicationsPublic
POST/api/v1/webhooks/configureBearer

Edge Functions LIVE

These backend functions are currently deployed and can be invoked via the Supabase client SDK.

FunctionStatus
ai-aquaculture-chatLive
ai-crop-intelligenceLive
ai-expert-prescriptionLive
ai-feed-growthLive
ai-pond-analyticsLive
ai-market-intelligenceLive
ai-supply-complianceLive
analyze-creatureLive
iot-webhookLive
weather-dataLive
water-alertsLive
community-benchmarksLive
Invocation Pattern
import { supabase } from "@/integrations/supabase/client";

const { data, error } = await supabase.functions.invoke(
  "ai-crop-intelligence",
  { body: { creature: "Shrimp", species: "Vannamei", cropData: {...} } }
);

SDK Quick Start

import fetch from 'node-fetch';

// List species
const species = await fetch('https://api.camaron.ai/v1/species', {
  headers: { 'x-api-key': process.env.CAMARON_API_KEY }
}).then(r => r.json());

// Push sensor data
await fetch('https://api.camaron.ai/v1/sensor-data', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.CAMARON_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    device_id: 'D001',
    ph: 7.8, temperature: 28.5, dissolved_oxygen: 5.2
  })
});

IoT Manufacturer Integration

1. Register Devices

Each sensor gets a unique device_key for authentication. Supports V1–V8 hardware profiles with GPS and pond assignment.

2. Push Sensor Data

HTTP POST to /api/v1/sensor-data with DO, pH, temp, salinity, ammonia, turbidity. Real-time ingestion across 30+ edge regions.

3. Access AI Insights

Your device data feeds 13 AI functions — water advisor, disease predictor, growth forecaster, risk scoring & more. Co-brand the intelligence layer with your hardware.

Ideal forSensor OEMsPCB ManufacturersFirmware TeamsIoT Startups

Developer Changelog

v1.42026-04-11
  • Interactive Try-It panels on all documented endpoints
  • Multi-language SDK snippets (JS, Python, cURL)
  • Developer changelog section
v1.32026-04-08
  • Added /api/v1/benchmark endpoint
  • SSE streaming for chat responses
  • Webhook callback configuration
v1.22026-03-25
  • Disease detection via YOLO V4
  • Feed optimization AI module
  • Rate limiting per API key
v1.12026-03-10
  • 163+ species database
  • Market price endpoints
  • IoT device registration

20 endpoints • 6-module AI Suite • SSE streaming • Webhook callbacks • 30+ region edge deployment

Request API Access