Developer API v1 Reference

OneSol AI Developer API Documentation

Build custom integrations, connect external chatbots, programmatically manage tool orders, check stock levels, and receive real-time webhooks.

Overview Authentication Tools Catalog Purchasing & Wallet Webhooks AutomateSocial / AI Studio

1. Base URL & Response Format

All API endpoints are served over HTTPS and return JSON responses. Errors use standard HTTP status codes (400, 401, 403, 404, 429, 500) with a structured error field.

https://onesolai.com/api/v1/

2. Authentication & API Keys

Generate your API keys in your Developer Dashboard. Every request must include an API Key in an HTTP Header:

Authorization: Bearer sk_live_your_secret_key_here

Public Key (`pk_live_...`)

Read-only scope. Use this key for querying tools catalog, stock availability, and prices.

Secret Key (`sk_live_...`)

Full control scope. Required to purchase tools using your wallet balance and manage orders.

3. Tools & Stock Availability API

GET /api/v1/tools/

Query live products, prices in NGN and USD, stock availability, and categories.

Query Parameters:

query (optional string): Search keyword e.g. capcut
category (optional string): Category slug e.g. video-creation

Example Request (cURL):

curl -X GET "https://onesolai.com/api/v1/tools/?query=capcut" \ -H "Authorization: Bearer pk_live_your_public_key"

Example Response (200 OK):

{ "success": true, "count": 1, "tools": [ { "id": 60, "name": "CapCut Pro 30 Days", "slug": "capcut-pro-30-days-1", "category": "Video Creation", "price_ngn": 9103.04, "price_usd": 6.67, "is_in_stock": true, "short_description": "Unlock premium video editing features with CapCut Pro for 30 days.", "detail_url": "https://onesolai.com/tools/capcut-pro-30-days-1/" } ] }

4. Purchasing Tools & Wallet API

POST /api/v1/orders/buy/

Purchase an AI tool programmatically. Automatically deducts the price from your wallet balance, triggers instant vendor fulfillment, and returns activation details.

Request Body (JSON):

{ "tool_id": 60, "delivery_email": "customer@example.com" }

Example Response (200 OK):

{ "success": true, "message": "Successfully purchased CapCut Pro 30 Days! Order #ORD-849201 processed.", "order": { "id": 142, "order_number": "ORD-849201", "tool_name": "CapCut Pro 30 Days", "amount_paid_ngn": 9103.04, "delivery_email": "customer@example.com", "access_details": "Login Email: user@vip.com | Pass: CapCut2026! | Link: https://..." } }

5. Real-Time Fulfillment Webhooks

When you save a Webhook URL in your dashboard, OneSol AI sends an instant HTTP POST event whenever an order delivery is completed.

Webhook Payload:

{ "event": "order.fulfilled", "order_id": 142, "order_number": "ORD-849201", "tool_name": "CapCut Pro 30 Days", "delivery_email": "customer@example.com", "access_details": "Login Email: user@vip.com | Pass: ...", "total_amount_ngn": 9103.04, "fulfilled_at": "2026-08-04T17:30:00Z" }

Signature Header:

X-OneSol-Signature: t=1722790800,v1=9f8a2b3c4...

AutomateSocial / AI Studio Integration Example

If you are building an AI chatbot on AutomateSocial (`hglobal.store`), configure your tools in AI Studio as follows:

• Tool 1 (Stock Check): HTTP Method: GET | URL: https://onesolai.com/api/agent/tools/
• Tool 2 (Buy Tool): HTTP Method: POST | URL: https://onesolai.com/api/agent/buy-tool/ | Header: X-Agent-Secret: onesol_agent_secret_2026