Orders API
在您的面板中将 smm.guide 添加为供应商。您在账户中创建的每个路由都是一项有独立 ID 的服务:您的面板将订单发送到该 ID,路由再将其传给您的供应商中第一个能够接单的。
三个步骤
该格式正是 SMM 面板之间已在使用的格式,因此无需任何编程。
https://smm.guide/api/v2 和密钥。导入服务:您的路由会连同 ID、价格和限额一起导入。请求格式
| HTTP 方法 | POST |
| API URL | https://smm.guide/api/v2 |
| 请求体 | application/x-www-form-urlencoded,或使用 JSON 并设置 Content-Type: application/json. A multipart/form-data 请求体同样可以读取,PHP 的 cURL 传入数组时发送的就是这种格式 |
| 响应 | JSON,始终返回 HTTP 200,即使请求体无法读取或请求过大也是如此。错误格式为 {"error": "…"} |
| 金额 | 美元。价格按每 1,000 计 |
服务列表
当前可以接单的路由。已关闭的路由或所有步骤均已停用的路由不会列出。
| 参数 | 说明 |
|---|---|
key | 您的 API 密钥 |
action | services |
响应
[
{
"service": 85725095,
"name": "TG views, main",
"type": "Default",
"category": "Telegram views",
"rate": "0.0018",
"min": "10",
"max": "1000000",
"refill": false,
"cancel": true,
"dripfeed": false
}
]rate 取该路由中可能接单的步骤的最高价格,包括暂时被跳过的步骤(今天宕机的面板明天可能恢复),因此订单的费用绝不会超过您面板导入的价格。 min 和 max 取所有可用步骤范围的并集;只适合其中部分步骤的数量会发往其中一个步骤。 refill 和 cancel 仅当所有这类步骤都提供时才为 true。
已关闭或没有任何可用步骤的路由会从此列表中移除,直到恢复为止。自动同步服务的面板会在同一时间段内在其一侧关闭该服务,这正是您想要的:否则它的订单会被拒绝。
添加订单
| 参数 | 说明 |
|---|---|
key | 您的 API 密钥 |
action | add |
service | 路由 ID,八位数字 |
link | 页面、帖子或个人主页的链接 |
quantity | 所需数量 |
响应
{
"order": 23501
}
无人接单
{
"error": "No step of this route accepted the order. …"
}无论最终由哪个供应商交付,订单号在订单的整个生命周期内保持不变。路由只接受链接和数量;分批投放、评论及其他额外字段会被拒绝。
订单状态
| 参数 | 说明 |
|---|---|
key | 您的 API 密钥 |
action | status |
order | 订单 ID |
响应
{
"charge": "0.0045",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}| 参数 | 说明 |
|---|---|
key | 您的 API 密钥 |
action | status |
orders | 订单 ID,用逗号分隔,最多 100 个 |
响应
{
"23501": {
"charge": "0.0045",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD"
},
"99": { "error": "Incorrect order ID" }
}| 状态 | 含义 |
|---|---|
Pending | 已被供应商接受,尚未开始。也包括供应商未给出明确答复的订单:路由会停在此处,直到您在账户中核实。 |
In progress, Processing | 供应商正在交付,或订单正在转往下一个步骤。 |
Completed | 已全部交付。 |
Partial | 部分交付; remains 表示未交付的部分。它统计所有步骤的交付量:当一个步骤交付了一部分、剩余部分在下一个步骤被取消时,订单状态为 Partial,而非 Canceled。剩余费用是否退还由供应商决定。 |
Canceled | 未交付任何内容,也没有其他步骤接单。 charge 显示仍被扣除的费用(如有)。 |
charge 是供应商为此订单收取的费用,按下单当日汇率折算为美元。 start_count 来自开始执行订单的供应商。
余额
smm.guide 不持有您的任何资金。该数字是您在路由背后各面板上的余额之和,以美元计。
| 参数 | 说明 |
|---|---|
key | 您的 API 密钥 |
action | balance |
响应
{
"balance": "126.1375",
"currency": "USD"
}取消
转交给当前持有订单的供应商(如果其服务支持取消)。您取消的订单绝不会再转往下一个步骤。
| 参数 | 说明 |
|---|---|
key | 您的 API 密钥 |
action | cancel |
orders | 订单 ID,用逗号分隔,最多 100 个 |
响应
[
{ "order": 23501, "cancel": 1 },
{ "order": 23502, "cancel": { "error": "The order is already finished" } }
]补量
转交给交付该订单的供应商。补量使用订单本身的订单号。
| 参数 | 说明 |
|---|---|
key | 您的 API 密钥 |
action | refill |
order | 订单 ID。或使用 orders:多个 ID,用逗号分隔 |
响应(单个订单)
{ "refill": "23501" }
响应(多个订单)
[
{ "order": 23501, "refill": 23501 },
{ "order": 23502, "refill": { "error": "…" } }
]| 参数 | 说明 |
|---|---|
key | 您的 API 密钥 |
action | refill_status |
refill | 补量 ID。或使用 refills:多个 ID,用逗号分隔 |
响应
{ "status": "Completed" }路由如何处理订单
- 步骤按您设定的顺序尝试,或优先尝试最便宜的可用步骤。 具体方式在路由中选择。
- 以下情况会跳过某个步骤: 其面板未响应;余额或每日限额不足以支付订单;数量超出其接受范围;价格高于您设定的上限;或按其价格计算,订单会超出路由自身的每日限额。跳过的步骤会自动恢复。
- 以下情况步骤会被停用: 其服务从价目表中下架,或面板开始以同一 ID 出售其他服务。其他步骤继续工作,并会通知您。
- 被拒绝时,订单会转往下一个步骤。 面板响应并拒绝时,不会产生任何扣费,因此会尝试下一个步骤。
- 未得到明确答复时,路由会停止。 超时或响应异常无法说明订单是否存在。继续转发可能导致重复交付和重复扣费,因此路由会停止,由您在账户中核实这一订单。
- 每个链接只能有一个进行中的订单。 某个链接的订单在路由上运行期间,同一链接的第二个订单会被拒绝,供应商自身也是这样处理的。
- 交付前的取消也可以转往下一个步骤, 前提是您开启了该选项。部分完成订单中未交付的部分,只有在您要求时才会转往下一个步骤。
错误
| 错误 | 含义 |
|---|---|
Invalid API key | 密钥错误、已被替换或已撤销。 |
This key is limited to certain addresses… | 请求来自不在密钥允许列表中的地址。 |
Incorrect request | 未知 action. |
Incorrect service ID | 您没有此 ID 的路由。已删除的路由会保留其编号,且绝不会分配给其他路由。 |
Incorrect order ID | 您没有此编号的订单。 |
Link is required, Quantity is required | 字段 add 中有一项缺失或不是数字。 |
A route takes a link and a quantity only | 请求中包含分批投放、评论或其他额外字段。 |
This route is switched off | 请在您的账户中开启。 |
This route already has an order for this link… | 请等待正在运行的订单完成。 |
No step of this route can take this order right now. … | 在发送任何内容之前,所有步骤都被跳过了。错误信息会列出每个面板及其原因。 |
No step of this route accepted the order. … | 所有被询问的步骤都拒绝了。未产生任何扣费。 |
Too many requests… | 超出下方限制。请等待一分钟。 |
示例
cURL
curl https://smm.guide/api/v2 \ -d key=sgo_… \ -d action=add \ -d service=85725095 \ -d link=https://t.me/channel/123 \ -d quantity=1000
PHP
function smmguide(array $post) {
$ch = curl_init('https://smm.guide/api/v2');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query(
['key' => 'sgo_…'] + $post),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 60,
]);
$out = json_decode(curl_exec($ch), true);
curl_close($ch);
return $out;
}
$order = smmguide(['action' => 'add',
'service' => 85725095,
'link' => 'https://t.me/channel/123',
'quantity' => 1000]);
每个 add 请求都会在 30 秒内得到响应,无一例外。路由可能会依次询问多个供应商;每个供应商分得剩余的时间,来不及等待的供应商则不会被询问。如果时间耗尽时最后一个被询问的供应商仍未响应,您会收到一个状态为 Pending 的订单号,路由会停在此处,直到得知答复。大多数订单在一两秒内就会得到响应。
限制与安全
- 每个密钥每分钟 300 次请求,其中下单请求 120 次。 单次请求最多 100 个订单 ID:
status调用。 - 密钥只显示一次,并以指纹形式保存。 您和我们都无法再次读取它。替换后旧密钥立即失效。
- 允许的地址。 在您的账户中填写您面板服务器的地址,密钥便无法在其他任何地方使用。
- 路由 ID 不是机密,也无需保密。 它只有与拥有该路由的账户的密钥一起使用才有效。
- 您的限额依然有效。 每个面板的每日限额、路由自身的每日限额及其单笔订单上限,对通过 API 下的订单与手动下的订单同样适用。
- 资金从不经过 smm.guide。 每笔订单都从您在接单面板上的余额中支付。退款和争议由您与该面板之间处理。
需要读取目录?
面板、Trust Score 和实时价格有独立的 API,以及面向 AI 助手的 MCP 服务器。