API Documentation

For developers and reseller panels connecting to Top Market Place Hub

This API uses the same request/response contract as most SMM reseller panels (SMMRaja, JustAnotherPanel, and similar) — if your software already knows how to talk to one of those, it can talk to this one with just a different base URL and key.

Base URL: https://topmarketplacehub.com/api/v2/index.php

Authentication

Every request needs your personal API key as a key parameter. Find (or generate) yours under Profile → Developer API once logged in. Treat it like a password — anyone with it can place orders using your wallet balance.

Making requests

POST or GET both work, with parameters sent as action plus whatever that action needs, alongside your key. All responses are JSON.

Actions

action=balance

Returns your current wallet balance.

curl -X POST https://topmarketplacehub.com/api/v2/index.php \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"

{"balance": "5000.00", "currency": "NGN"}

action=services

Returns every active Boosting (SMM) service you can order.

curl -X POST https://topmarketplacehub.com/api/v2/index.php \
  -d "key=YOUR_API_KEY" \
  -d "action=services"

[
  {
    "service": 12,
    "name": "Instagram followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "970.00",
    "min": 100,
    "max": 50000
  }
]

action=add

Places an order. Debits your wallet immediately.

Param	Required	Description
`service`	Yes	The service ID from `action=services`
`link`	Yes	The profile or post URL to deliver to
`quantity`	Yes	Must fall within that service's min/max

curl -X POST https://topmarketplacehub.com/api/v2/index.php \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=12" \
  -d "link=https://instagram.com/example" \
  -d "quantity=1000"

{"order": 4821}

On failure (insufficient balance, invalid quantity, service unavailable), you'll get an error object instead, and nothing is charged:

{"error": "Insufficient wallet balance."}

action=status

Checks one order's status.

curl -X POST https://topmarketplacehub.com/api/v2/index.php \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "order=4821"

{
  "charge": "970.00",
  "start_count": "0",
  "status": "In progress",
  "remains": "0",
  "currency": "NGN"
}

Possible status values: Pending, In progress, Partial, Completed, Canceled.

action=multistatus

Checks several orders at once.

curl -X POST https://topmarketplacehub.com/api/v2/index.php \
  -d "key=YOUR_API_KEY" \
  -d "action=multistatus" \
  -d "orders=4821,4822"

{
  "4821": { "charge": "970.00", "status": "Completed", "remains": "0", "currency": "NGN" },
  "4822": { "charge": "430.00", "status": "Pending", "remains": "0", "currency": "NGN" }
}

Errors

Any problem returns a plain error object instead of the normal response shape:

{"error": "Invalid API key"}

Scope

This API currently covers Boosting (SMM) services only. Numbers and Logs aren't available through it yet.