Developer API · v1

Build with Geerok

Integrate crypto buying, live Naira prices, wallet management, and OTC trading into your platform with a clean REST API.

Base URL

https://geerok.name.ng

Auth

Session cookie

Format

JSON

Authentication

Geerok uses session-based auth with httpOnly cookies. Here's the flow:

POST to /api/auth/sign-in with email + password
Server responds with a secure session cookie
Include credentials: "include" in all requests

JavaScript Example

// 1. Sign in
await fetch("https://geerok.name.ng/api/auth/sign-in", {
  method: "POST",
  credentials: "include",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email, password })
})

// 2. Make authenticated call
const res = await fetch("https://geerok.name.ng/api/user/wallet", {
  credentials: "include"
})
const { balance } = await res.json()
console.log("Balance:", balance)

Error Handling

All errors return JSON with an error field.

// Response format
{ "error": "Human-readable message" }

// Status codes
// 400 — Bad request / insufficient balance
// 401 — Unauthorized (not signed in)
// 403 — Forbidden (missing permission)
// 404 — Resource not found
// 503 — Exchange temporarily unavailable
// 500 — Internal error

Authentication

(5)

POST/api/auth/sign-up

Create a new account

Request Body

{ "email": "user@example.com", "password": "min8chars", "fullName": "John Doe" }

Response

{ "success": true, "needsVerification": true }

POST/api/auth/sign-in

Request Body

{ "email": "user@example.com", "password": "password" }

Response

{ "success": true, "user": { "id": 1, "email": "..." } }

POST/api/auth/sign-out Auth

Destroy current session

Response

{ "success": true }

POST/api/auth/forgot-password

Send reset email

Request Body

{ "email": "user@example.com" }

Response

{ "success": true }

POST/api/auth/reset-password

Reset password with token

Request Body

{ "token": "...", "password": "new" }

Response

{ "success": true }

Wallet & Prices

(3)

GET/api/user/wallet Auth

Get wallet balance

Response

{ "balance": 25000.00 }

GET/api/user/price?symbol=BTC Auth

Live Naira price for any token

Response

{ "symbol": "BTC", "naira_price": 98500000, "usdt_price": 61562, "provider": "P3" }

GET/api/user/settings

Public platform settings

Response

{ "usd_ngn_rate": "1600", "min_deposit_naira": "5000" }

Orders

(3)

POST/api/user/buy-crypto Auth

Place crypto buy order

Request Body

{ "tokenSymbol": "BTC", "nairaAmount": 50000, "walletAddress": "bc1q..." }

Response

{ "success": true, "orderId": 42, "orderNumber": "GRK-1234567" }

GET/api/user/otc-tokens Auth

List Peer Exchange tokens

Response

{ "tokens": [{ "id": 1, "ticker": "PI", "price_naira": 9000 }] }

POST/api/user/otc-order Auth

Place OTC buy/sell order

Request Body

{ "tokenId": 1, "nairaAmount": 5000, "walletAddress": "pi_addr", "type": "buy" }

Response

{ "success": true, "orderId": 43 }

Deposits

(2)

GET/api/user/deposit-info

Bank accounts + min deposit

Response

{ "bank_accounts": "[{...}]", "min_deposit": "5000" }

POST/api/user/deposit Auth

Submit deposit after transfer

Request Body

{ "amount_naira": 10000, "bank_name": "GTB", "reference": "TXN123456" }

Response

{ "success": true }

Notifications

(2)

GET/api/user/notifications Auth

List notifications + unread count

Response

{ "notifications": [...], "unreadCount": 3 }

POST/api/user/notifications Auth

Mark all as read

Response

{ "success": true }

KYC & Support

(4)

GET/api/user/kyc-tickets Auth

List KYC support tickets

Response

{ "tickets": [...] }

POST/api/user/kyc-tickets Auth

Submit KYC ticket (deducts wallet)

Request Body

{ "problemType": "...", "platform": "Bybit", "description": "..." }

Response

{ "success": true, "ticket": {...} }

GET/api/user/sidra-appointments Auth

List Sidra appointments

Response

{ "appointments": [...] }

POST/api/user/sidra-appointments Auth

Book Sidra verification

Request Body

{ "username": "...", "phone": "+234...", "preferred_date": "...", "preferred_time": "..." }

Response

{ "success": true, "appointment": {...} }

Profile

(3)

GET/api/user/profile Auth

Get authenticated user profile

Response

{ "user": { "full_name": "John", "email": "..." } }

POST/api/user/profile Auth

Update profile

Request Body

{ "full_name": "John", "phone": "+234..." }

Response

{ "success": true }

POST/api/user/change-password Auth

Change password

Request Body

{ "currentPassword": "...", "newPassword": "..." }

Response

{ "success": true }

Rate Limits

Price endpoint60/min

Order endpoints10/min

Authentication5/min

Other endpoints120/min

Need higher limits? Email developers@geerok.name.ng

Ready to integrate?

Create a free account and generate your API key.

Create Account Contact Us

Loading…

Developer API · v1

Build with Geerok

Integrate crypto buying, live Naira prices, wallet management, and OTC trading into your platform with a clean REST API.

Base URL

https://geerok.name.ng

Auth

Session cookie

Format

JSON

Authentication

Geerok uses session-based auth with httpOnly cookies. Here's the flow:

POST to /api/auth/sign-in with email + password
Server responds with a secure session cookie
Include credentials: "include" in all requests

JavaScript Example

// 1. Sign in
await fetch("https://geerok.name.ng/api/auth/sign-in", {
  method: "POST",
  credentials: "include",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email, password })
})

// 2. Make authenticated call
const res = await fetch("https://geerok.name.ng/api/user/wallet", {
  credentials: "include"
})
const { balance } = await res.json()
console.log("Balance:", balance)

Error Handling

All errors return JSON with an error field.

// Response format
{ "error": "Human-readable message" }

// Status codes
// 400 — Bad request / insufficient balance
// 401 — Unauthorized (not signed in)
// 403 — Forbidden (missing permission)
// 404 — Resource not found
// 503 — Exchange temporarily unavailable
// 500 — Internal error

Authentication

(5)

POST/api/auth/sign-up

Create a new account

Request Body

{ "email": "user@example.com", "password": "min8chars", "fullName": "John Doe" }

Response

{ "success": true, "needsVerification": true }

POST/api/auth/sign-in

Request Body

{ "email": "user@example.com", "password": "password" }

Response

{ "success": true, "user": { "id": 1, "email": "..." } }

POST/api/auth/sign-out Auth

Destroy current session

Response

{ "success": true }

POST/api/auth/forgot-password

Send reset email

Request Body

{ "email": "user@example.com" }

Response

{ "success": true }

POST/api/auth/reset-password

Reset password with token

Request Body

{ "token": "...", "password": "new" }

Response

{ "success": true }

Wallet & Prices

(3)

GET/api/user/wallet Auth

Get wallet balance

Response

{ "balance": 25000.00 }

GET/api/user/price?symbol=BTC Auth

Live Naira price for any token

Response

{ "symbol": "BTC", "naira_price": 98500000, "usdt_price": 61562, "provider": "P3" }

GET/api/user/settings

Public platform settings

Response

{ "usd_ngn_rate": "1600", "min_deposit_naira": "5000" }

Orders

(3)

POST/api/user/buy-crypto Auth

Place crypto buy order

Request Body

{ "tokenSymbol": "BTC", "nairaAmount": 50000, "walletAddress": "bc1q..." }

Response

{ "success": true, "orderId": 42, "orderNumber": "GRK-1234567" }

GET/api/user/otc-tokens Auth

List Peer Exchange tokens

Response

{ "tokens": [{ "id": 1, "ticker": "PI", "price_naira": 9000 }] }

POST/api/user/otc-order Auth

Place OTC buy/sell order

Request Body

{ "tokenId": 1, "nairaAmount": 5000, "walletAddress": "pi_addr", "type": "buy" }

Response

{ "success": true, "orderId": 43 }

Deposits

(2)

GET/api/user/deposit-info

Bank accounts + min deposit

Response

{ "bank_accounts": "[{...}]", "min_deposit": "5000" }

POST/api/user/deposit Auth

Submit deposit after transfer

Request Body

{ "amount_naira": 10000, "bank_name": "GTB", "reference": "TXN123456" }

Response

{ "success": true }

Notifications

(2)

GET/api/user/notifications Auth

List notifications + unread count

Response

{ "notifications": [...], "unreadCount": 3 }

POST/api/user/notifications Auth

Mark all as read

Response

{ "success": true }

KYC & Support

(4)

GET/api/user/kyc-tickets Auth

List KYC support tickets

Response

{ "tickets": [...] }

POST/api/user/kyc-tickets Auth

Submit KYC ticket (deducts wallet)

Request Body

{ "problemType": "...", "platform": "Bybit", "description": "..." }

Response

{ "success": true, "ticket": {...} }

GET/api/user/sidra-appointments Auth

List Sidra appointments

Response

{ "appointments": [...] }

POST/api/user/sidra-appointments Auth

Book Sidra verification

Request Body

{ "username": "...", "phone": "+234...", "preferred_date": "...", "preferred_time": "..." }

Response

{ "success": true, "appointment": {...} }

Profile

(3)

GET/api/user/profile Auth

Get authenticated user profile

Response

{ "user": { "full_name": "John", "email": "..." } }

POST/api/user/profile Auth

Update profile

Request Body

{ "full_name": "John", "phone": "+234..." }

Response

{ "success": true }

POST/api/user/change-password Auth

Change password

Request Body

{ "currentPassword": "...", "newPassword": "..." }

Response

{ "success": true }

Rate Limits

Price endpoint60/min

Order endpoints10/min

Authentication5/min

Other endpoints120/min

Need higher limits? Email developers@geerok.name.ng

Ready to integrate?

Create a free account and generate your API key.

Create Account Contact Us