Skip to main content

​
Quickstart

Get OLIVE running and make your first API call in 5 minutes.

​
Prerequisites

  • Docker and Docker Compose
  • cURL or API client

​
1. Start Services

git clone https://github.com/EmmanuelKeifala/olive.git
cd olive
docker compose up -d --build gateway wallet-core agent

​
2. Verify Health

curl http://localhost:8080/health

​
3. Your First API Call

​
Check Balance

curl -X GET "http://localhost:8080/api/v1/balance/user123" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Create Payment

curl -X POST "http://localhost:8080/api/v1/payments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "user123",
    "recipient": "user456",
    "amount": 5000,
    "currency": "SLE"
  }'

​
Next Steps

Register Subscribers

User registration guide

API Reference

Complete API documentation