AstroSMM — API Documentation

A key/action HTTP API, compatible with the standard SMM panel protocol. Send an HTTP POST request with your parameters.

POST https://astrosmm.com/api/v2

Alias: https://astrosmm.com/api/v1 — same handler, both versions work.

Authentication

Every request must include your API key as the key parameter. Optional header Idempotency-Key on add prevents duplicate orders on retry.

Actions

`action=add`

Create a new order.

`key`	Your API key
`action`	add
`service`	Service ID
`link`	Target link
`quantity`	Needed quantity
`runs`	(optional) Runs to deliver — drip-feed
`interval`	(optional) Interval in minutes — drip-feed
`comments`	(optional) Comments list, one per line — custom_comments

Example response:

{
    "status": "success",
    "order": 23501
}

`action=status`

Order status. Single (order=ID) or multiple (orders=ID,ID,ID).

`key`	Your API key
`action`	status
`order`	Order ID

Example response:

{
    "charge": "1.2000",
    "start_count": 3572,
    "status": "Partial",
    "remains": 157,
    "currency": "USD"
}

`action=status (multiple)`

Up to 100 orders keyed by order id.

`key`	Your API key
`action`	status
`orders`	1,10,100

Example response:

{
    "1": {
        "charge": "0.9000",
        "start_count": 500,
        "status": "Completed",
        "remains": 0,
        "currency": "USD"
    },
    "10": {
        "error": "Incorrect order ID"
    }
}

`action=services`

The service catalogue with the price YOU pay (rate).

`key`	Your API key
`action`	services

Example response:

[
    {
        "service": 1,
        "name": "Instagram Followers",
        "type": "default",
        "category": "Instagram",
        "rate": "0.9000",
        "min": 50,
        "max": 10000,
        "dripfeed": 1,
        "refill": true,
        "cancel": false
    }
]

`action=balance`

Your wallet balance.

`key`	Your API key
`action`	balance

Example response:

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

`action=refill`

Request a refill. Single (order=ID) or multiple (orders=ID,ID).

`key`	Your API key
`action`	refill
`order`	Order ID

Example response:

{
    "refill": 1
}

`action=refill_status`

Refill status. Single (refill=ID) or multiple (refills=ID,ID).

`key`	Your API key
`action`	refill_status
`refill`	Refill ID

Example response:

{
    "status": "Completed"
}

`action=cancel`

Request cancellation (superset — not in the classic reference-panel API). Single (order=ID) or multiple (orders=ID,ID).

`key`	Your API key
`action`	cancel
`orders`	1,10

Example response:

[
    {
        "order": 1,
        "cancel": 1
    },
    {
        "order": 10,
        "error": "This order cannot be canceled."
    }
]

Order statuses

Pending In progress Processing Completed Partial Canceled Refunded