Developer Resources

Build With Us

Complete API documentation, integration guides, and technical resources for developers building on the OmniFarm and AgriToken platforms.

API Reference

RESTful endpoints

Guides & Tutorials

Step-by-step walkthroughs

Code Examples

Working implementations

API Reference

RESTful API Endpoints

Access OmniFarm sensor data and AgriToken blockchain operations via our secure API.

Base URL

api.serveagro.com

Authentication

Bearer Token (API Key)

Response Format

JSON

GET/api/v1/sensors/{sensor_id}/readings

Retrieve real-time sensor data for soil moisture, pH, and NPK levels

Authentication: API Key

Example Request

curl -X GET "https://api.serveagro.com/v1/sensors/hub_001/readings" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "sensor_id": "hub_001",
  "timestamp": "2026-02-14T10:30:00Z",
  "moisture": 22.5,
  "ph": 6.8,
  "npk": { "n": 45, "p": 32, "k": 28 },
  "battery": 87
}

POST/api/v1/tokens/mint

Mint new AgriTokens based on verified crop value or carbon sequestration

Authentication: API Key + Signature

Example Request

curl -X POST "https://api.serveagro.com/v1/tokens/mint" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "farmer_id": "farmer_12345",
    "token_type": "carbon",
    "amount": 2.5,
    "verification_hash": "0x..."
  }'

Example Response

{
  "transaction_id": "tx_67890",
  "tokens_minted": 2.5,
  "token_address": "0x...",
  "status": "confirmed"
}

GET/api/v1/farmers/{farmer_id}/wallet

Get AgriToken wallet balance and transaction history via USSD integration

Authentication: API Key

Example Request

curl -X GET "https://api.serveagro.com/v1/farmers/farmer_12345/wallet" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "farmer_id": "farmer_12345",
  "balance": 25000,
  "balance_usd": 42.50,
  "transactions": [...]
}

Get Your API Key

Request access to our developer API for building integrations with OmniFarm and AgriToken platforms.

Request API Access

Technical Guides

Step-by-Step Tutorials

Comprehensive guides to help you integrate and build on our platforms.

Getting Started with OmniFarm

Beginner30 minutes

Set up your first sensor hub, configure edge-AI processing, and integrate with your farm management system.

TOPICS COVERED

Hub installation

Sensor calibration

Cloud sync

Alert configuration

Read Guide →

AgriToken Integration Guide

Intermediate45 minutes

Implement USSD wallet functionality and enable token trading in your agricultural platform.

TOPICS COVERED

Wallet creation

USSD gateway

Token minting

Transaction handling

Read Guide →

Carbon Credit Verification

Advanced20 minutes

Understand the process of minting verified carbon credits from agricultural practices.

TOPICS COVERED

Data validation

Blockchain recording

Third-party audits

Market listing

Read Guide →

Offline-First Architecture

Advanced60 minutes

Build applications that work reliably in low-connectivity rural environments.

TOPICS COVERED

Edge computing

Data synchronization

Conflict resolution

SMS/USSD protocols

Read Guide →

Developer Resources

Tools, libraries, and community support to accelerate your development.

CLI Tools

Command-line utilities for hub management and data analysis

Install CLI →

SDKs

Official libraries for JavaScript, Python, and Go

Browse SDKs →

GitHub

Open-source code samples and community contributions

View on GitHub →

Developer Forum

Get help from the community and our engineering team

Join Discussion →

Code Examples

Integration Examples

Working code examples to jumpstart your integration.

Fetch Sensor Data (JavaScript)

javascript

// Initialize the OmniFarm SDK
import { OmniFarm } from '@serve-agro/omnifarm-sdk';

const farm = new OmniFarm({
  apiKey: process.env.OMNIFARM_API_KEY
});

// Get real-time sensor readings
const readings = await farm.sensors.getReadings('hub_001');

console.log(`Soil moisture: ${readings.moisture}%`);
console.log(`pH level: ${readings.ph}`);
console.log(`NPK: N:${readings.npk.n} P:${readings.npk.p} K:${readings.npk.k}`);

Mint Carbon Tokens (Python)

python

# Import AgriToken SDK
from serve_agro import AgriToken

# Initialize client
client = AgriToken(api_key=os.getenv('AGRITOKEN_API_KEY'))

# Mint carbon credits
transaction = client.tokens.mint(
    farmer_id='farmer_12345',
    token_type='carbon',
    amount=2.5,  # tCO2e
    verification_hash='0x...'
)

print(f"Minted {transaction.tokens_minted} tokens")
print(f"Transaction ID: {transaction.id}")

USSD Wallet Integration (Go)

package main

import (
    "github.com/serve-agro/agritoken-go"
)

func main() {
    // Initialize wallet client
    client := agritoken.NewClient(os.Getenv("API_KEY"))
    
    // Get wallet balance
    wallet, err := client.Wallet.Get("farmer_12345")
    if err != nil {
        log.Fatal(err)
    }
    
    fmt.Printf("Balance: %d tokens ($%.2f)\n", 
        wallet.Balance, wallet.BalanceUSD)
}