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