Preview: you can test catalog, account balance and order requests. Top-ups and boost delivery are disabled. Example IDs, prices and responses below are illustrative; fetch services for current IDs and rates.
Basics
| URL | https://api.web3smm.com/api/v2 |
|---|---|
| Method | POST |
| Body | application/x-www-form-urlencoded, multipart/form-data or JSON |
| Authentication | key in the body (or Authorization: Bearer). Keys in the URL are rejected. |
| Response | JSON. Business errors use {"error": "…"} with HTTP 200. Request-size, rate-limit or server failures can return other HTTP statuses. |
| Rates | Default: price per 1,000 units (the website shows the price of one unit). Package: price per package; quantity is always 1. Charges are rounded up to the cent. |
| Limits | 120 requests per minute per key; 30 per minute for add and cancel. Over the limit: HTTP 429 with Retry-After. |
Create a key in your account and choose its permissions. Each action needs the permission shown below.
curl -X POST https://api.web3smm.com/api/v2 \
-d key=YOUR_KEY \
-d action=add -d service=1 -d quantity=100 \
-d link=0x6982508145454Ce325dDbE47a25d4ec3d2311933 \
-d idempotency_key=my-order-0001action=services
Permission: services:read
| Parameter | Description |
|---|---|
key | Your API key |
action | services |
[
{
"service": 1,
"name": "DEXTools bullish votes",
"type": "Default",
"category": "DEXTools Votes",
"rate": "240.00",
"min": "20",
"max": "500",
"refill": false,
"cancel": true
},
{
"service": 7,
"name": "GeckoTerminal pool trending",
"type": "Package",
"category": "GeckoTerminal Trending",
"rate": "120.00",
"min": "1",
"max": "1",
"refill": false,
"cancel": true
}
]action=add
Permission: orders:write
| Parameter | Description |
|---|---|
key | Your API key |
action | add |
service | Service ID |
link | Token address, pair or page URL |
quantity | Needed quantity (ignored for Package services) |
idempotency_key (optional) | Up to 100 characters [A-Za-z0-9_.:-]. Repeating a request with the same key returns the same order instead of creating a new one. |
{ "order": 100023 }action=status
Permission: orders:read
| Parameter | Description |
|---|---|
key | Your API key |
action | status |
order | Order ID |
{
"charge": "4.80",
"start_count": "0",
"status": "Pending",
"remains": "20",
"currency": "USD"
}action=status (multiple)
Permission: orders:read
| Parameter | Description |
|---|---|
key | Your API key |
action | status |
orders | Order IDs, comma-separated, up to 100 |
{
"100023": { "charge": "4.80", "start_count": "0", "status": "In progress", "remains": "20", "currency": "USD" },
"100024": { "error": "Incorrect order ID" }
}action=cancel
Permission: orders:write
| Parameter | Description |
|---|---|
key | Your API key |
action | cancel |
orders | Order IDs, comma-separated, up to 100 |
[
{ "order": 100023, "cancel": 1 },
{ "order": 100024, "cancel": { "error": "Incorrect order ID" } }
]action=balance
Permission: balance:read
| Parameter | Description |
|---|---|
key | Your API key |
action | balance |
{ "balance": "100.84", "currency": "USD" }Order statuses
The response format supports Pending, In progress, Completed, Partial and Canceled. Preview orders stay pending until canceled; no supplier delivery is running. Cancellation is available only before dispatch, releases the full reservation and reports "charge": "0". Final and partial delivery reconciliation is not enabled yet.
Not supported yet
refill and refill_status answer with an error. Service types other than Default and Package (custom comments, mentions, polls…) are not offered.