홈 / 개발자 / Orders API

Orders API

smm.guide를 내 패널에 공급업체로 추가하세요. 계정에서 만든 각 라우트는 고유 ID를 가진 서비스입니다. 패널이 해당 ID로 주문을 보내면, 라우트가 주문을 받을 수 있는 첫 번째 공급업체로 주문을 전달합니다.

세 단계

SMM 패널끼리 이미 사용하는 형식이므로 따로 프로그래밍할 필요가 없습니다.

1라우트 만들기계정 → Orders desk → 라우트. 제공할 서비스를 선택하고, 연결된 패널에서 같은 유형의 서비스를 최대 5개까지 추가하세요.
2키 만들기Orders desk → Orders API. 키는 한 번만 표시됩니다. 패널 서버 주소에서만 작동하도록 제한할 수 있습니다.
3내 패널에 공급업체 추가API URL https://smm.guide/api/v2 및 키를 입력하세요. 서비스를 가져오면 라우트가 ID, 가격, 한도와 함께 들어옵니다.

요청 형식

HTTP 메서드POST
API URLhttps://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 키
actionservices

응답

[
  {
    "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 키
actionadd
service라우트 ID(8자리)
link페이지, 게시물 또는 프로필 링크
quantity필요 수량

응답

{
  "order": 23501
}

받은 곳 없음

{
  "error": "No step of this route accepted the order. …"
}

어느 공급업체가 최종 처리하든 주문 번호는 주문이 끝날 때까지 바뀌지 않습니다. 라우트는 링크와 수량만 받으며, 드립피드, 댓글 등 추가 필드는 거부됩니다.

주문 상태

매개변수설명
key내 API 키
actionstatus
order주문 ID

응답

{
  "charge": "0.0045",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}
매개변수설명
key내 API 키
actionstatus
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 값은 처리되지 않은 수량입니다. 모든 단계에서 처리한 수량을 합산하므로, 한 단계에서 일부를 처리하고 나머지가 다음 단계에서 취소되면 주문은 Canceled가 아닌 Partial입니다. 남은 금액의 반환 여부는 공급업체가 결정합니다.
Canceled처리된 것이 없으며, 다른 단계도 주문을 받지 않았습니다. charge 값은 결제된 금액이 남아 있다면 그 금액을 보여 줍니다.

charge 값은 공급업체가 이 주문에 청구한 금액으로, 주문일 환율 기준 달러입니다. start_count 값은 주문을 시작한 공급업체에서 가져옵니다.

잔액

smm.guide는 고객님의 돈을 보관하지 않습니다. 이 수치는 라우트에 연결된 패널들의 잔액 합계(달러)입니다.

매개변수설명
key내 API 키
actionbalance

응답

{
  "balance": "126.1375",
  "currency": "USD"
}

취소

현재 주문을 보유한 공급업체에 전달되며, 해당 서비스가 취소를 지원해야 합니다. 취소한 주문은 다음 단계로 넘어가지 않습니다.

매개변수설명
key내 API 키
actioncancel
orders쉼표로 구분한 주문 ID, 최대 100개

응답

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "The order is already finished" } }
]

리필

주문을 처리한 공급업체에 전달됩니다. 리필은 주문 자체의 번호를 사용합니다.

매개변수설명
key내 API 키
actionrefill
order주문 ID. 또는 orders: 쉼표로 구분한 여러 개

응답(주문 1건)

{ "refill": "23501" }

응답(여러 건)

[
  { "order": 23501, "refill": 23501 },
  { "order": 23502, "refill": { "error": "…" } }
]
매개변수설명
key내 API 키
actionrefill_status
refill리필 ID. 또는 refills: 쉼표로 구분한 여러 개

응답

{ "status": "Completed" }

라우트의 주문 처리 방식

  • 단계는 내가 정한 순서대로, 또는 작동 중인 가장 저렴한 단계부터 시도합니다. 어느 방식을 쓸지는 라우트에서 선택합니다.
  • 단계를 건너뛰는 경우: 패널이 응답하지 않을 때, 잔액이나 일일 한도가 주문 금액에 못 미칠 때, 수량이 허용 범위를 벗어날 때, 가격이 설정한 한도보다 높을 때, 또는 해당 가격으로 주문하면 라우트 자체의 일일 한도를 넘을 때. 이 단계는 자동으로 복귀합니다.
  • 단계가 제외되는 경우: 서비스가 가격표에서 빠지거나, 패널이 같은 ID로 다른 서비스를 판매하기 시작할 때. 나머지 단계는 계속 작동하며 알림이 발송됩니다.
  • 거부되면 주문이 다음으로 넘어갑니다. 패널이 응답하고 거부하면 결제된 것이 없으므로 다음 단계를 시도합니다.
  • 명확한 응답이 없으면 멈춥니다. 시간 초과나 비정상 응답으로는 주문이 생성되었는지 알 수 없습니다. 다음으로 넘기면 중복 처리와 이중 결제가 생길 수 있으므로, 라우트가 멈추고 해당 주문을 계정에서 직접 확인하게 됩니다.
  • 링크당 진행 중인 주문은 1건. 라우트에서 한 링크의 주문이 진행 중이면 같은 링크의 두 번째 주문은 거부됩니다. 공급업체들도 같은 방식으로 처리합니다.
  • 처리 전에 취소된 주문도 다음 단계로 넘길 수 있습니다, 해당 옵션을 켠 경우에 한합니다. 부분 완료 주문의 미처리 수량은 요청한 경우에만 넘어갑니다.

오류

오류의미
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…아래 한도를 초과했습니다. 1분 후 다시 시도하세요.

예시

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]);

다음 요청은 항상 30초 이내에 응답합니다: add — 라우트는 여러 공급업체에 차례로 요청할 수 있으며, 각 공급업체에는 남은 시간이 주어지고 기다릴 시간이 없으면 해당 공급업체에는 요청하지 않습니다. 마지막으로 요청한 공급업체가 시간 안에 응답하지 않으면 Pending 상태의 주문 번호를 받게 되며, 결과가 확인될 때까지 라우트는 멈춥니다. 대부분의 주문은 1~2초 안에 응답합니다.

한도 및 보안

  • 키당 분당 300회 요청, 그중 주문은 120회. 한 번에 최대 100개의 주문 ID status 호출.
  • 키는 한 번만 표시되며 지문 형태로 보관됩니다. 고객님도 저희도 다시 읽을 수 없습니다. 새 키로 교체하면 이전 키는 즉시 비활성화됩니다.
  • 허용 주소. 계정에 패널 서버 주소를 등록하면 다른 곳에서는 키가 작동하지 않습니다.
  • 라우트 ID는 비밀이 아니며, 비밀일 필요도 없습니다. 라우트를 소유한 계정의 키와 함께 써야만 작동합니다.
  • 설정한 한도는 그대로 적용됩니다. 각 패널의 일일 한도, 라우트 자체의 일일 한도와 1회 최대 주문은 API로 들어온 주문에도 직접 넣은 주문과 똑같이 적용됩니다.
  • 돈은 smm.guide를 거치지 않습니다. 각 주문은 주문을 받은 패널의 잔액에서 결제됩니다. 환불과 분쟁은 고객님과 해당 패널 사이에서 처리됩니다.

카탈로그 데이터가 필요하신가요?

패널, Trust Score, 실시간 가격은 별도의 API와 어시스턴트용 MCP 서버로 제공됩니다.