프록시 API 문서, 주문과 접속 정보 자동화
SMMProxy 개발자 API는 잔액 조회, 가격 조회, 프록시 주문, 접속 정보 목록을 HTTPS REST로 제공해요. 대시보드의 API 키 메뉴에서 키를 만들고 Authorization 헤더에 Bearer 키로 보내요.
시작하기
- 계정을 만들고 첫 충전을 마쳐요. API 키는 충전이 한 번 반영된 계정에서 만들 수 있어요.
- 대시보드의 API 키 메뉴에서 새 키를 만들어요. 키는 만들 때 한 번만 보여 주니 바로 저장해요.
- 모든 요청에 Authorization: Bearer 키를 넣어요. 응답은 JSON이고 늘 ok 칸이 있어요.
기본 주소: https://smmproxy.io/api/v1
curl -H "Authorization: Bearer smpk_YOUR_KEY" https://smmproxy.io/api/v1/balance
GET/api/v1/balance
잔액 조회
응답 예시
{ "ok": true, "balance": "48.20", "currency": "USD" }GET/api/v1/products
상품·나라·가격 조회
응답 예시
{ "ok": true, "periods": ["1w","2w","1m","2m","3m","6m","9m","12m"],
"products": [{ "product": "isp", "unit": "ip", "countries": [{ "country": "us", "monthly": "1.29" }] }] }POST/api/v1/orders
프록시 주문 (잔액에서 결제)
요청 본문
{ "product": "isp", "country": "us", "quantity": 5, "period": "1m" }응답 예시
{ "ok": true, "order": { "id": "OR-7K2M-Q8XD4P", "product": "isp", "country": "us",
"quantity": 5, "period": "1m", "total": "6.45", "expires_at": "2026-11-21T09:00:00.000Z" } }GET/api/v1/orders
주문 목록 (최근 100건)
응답 예시
{ "ok": true, "orders": [{ "id": "OR-7K2M-Q8XD4P", "status": "active", "total": "6.45" }] }GET/api/v1/proxies?order=OR-7K2M-Q8XD4P
접속 정보 목록
응답 예시
{ "ok": true, "proxies": [{ "host": "198.51.100.24", "http_port": 10842, "socks5_port": 20842,
"username": "u7kq2m", "password": "Xc81pLq0Zr", "country": "us", "expires_at": "..." }] }주문 값
| 이름 | 형식 | 설명 |
|---|---|---|
| product | string | isp, mobile, ipv4, residential |
| country | string | 나라 코드 2자리 소문자 (us, gb, de ...) |
| quantity | integer | IP·포트 수, 주거용은 GB |
| period | string | 1w 2w 1m 2m 3m 6m 9m 12m (주거용은 넣지 않음) |
| protocol | string | http 또는 socks5, 기본 http (두 포트 모두 발급돼요) |
오류
| HTTP | error | 뜻 |
|---|---|---|
| 401 | unauthorized | 키가 없거나 맞지 않아요. 돈은 빠지지 않아요. |
| 400 | invalid_request | 상품, 나라, 수량, 기간 값을 다시 확인해 주세요. 돈은 빠지지 않아요. |
| 402 | insufficient_balance | 잔액이 결제 금액보다 적어요. 충전한 뒤 다시 보내요. 돈은 빠지지 않아요. |
| 503 | network_error | 주문 전달 중 네트워크 오류예요. 돈은 빠지지 않고 잠시 뒤 다시 보낼 수 있어요. |
| 429 | rate_limited | 1분에 300번까지 보낼 수 있어요. |
Python 예시
import requests
API = "https://smmproxy.io/api/v1"
H = {"Authorization": "Bearer smpk_YOUR_KEY"}
order = requests.post(f"{API}/orders", headers=H, json={
"product": "isp", "country": "us", "quantity": 5, "period": "1m"}).json()
if order["ok"]:
proxies = requests.get(f"{API}/proxies", headers=H, params={"order": order["order"]["id"]}).json()
for p in proxies["proxies"]:
print(f'{p["host"]}:{p["http_port"]}:{p["username"]}:{p["password"]}')Node.js 예시
const API = "https://smmproxy.io/api/v1";
const H = { Authorization: "Bearer smpk_YOUR_KEY", "Content-Type": "application/json" };
const r = await fetch(API + "/orders", { method: "POST", headers: H,
body: JSON.stringify({ product: "mobile", country: "gb", quantity: 1, period: "1m" }) });
const j = await r.json();
console.log(j.ok ? j.order.id : j.error);