API Documentation — Palladium SMM

Authentication

All API requests must include the key parameter — your unique API key. The key can be found in the API section of your panel.

POST request

                                
POST https://palladium-smm.com/api/v2
Content-Type: application/x-www-form-urlencoded

key=YOUR_API_KEY&action=balance

GET request

GET https://palladium-smm.com/api/v2?key=YOUR_API_KEY&action=balance

Never expose your API key in client-side JavaScript. Use the key only on the server side.

balance Balance

action=balance Returns the current user balance

Parameters

Parameter	Type
`key`	string	required
`action`	string	required

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

services Service list

action=services Returns all available services

Parameters

Parameter	Type
`key`	string	required
`action`	string	required

                                
[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "rate": "1.5000",
    "min": 100,
    "max": 10000,
    "refill": true,
    "cancel": false,
    "category": "Instagram",
    "description": ""
  }
]

rate — price per 1000 units in USD.

add Create order

action=add action=create Creates a new order, deducts funds from balance

Parameters

Parameter	Type	Description
`key`	string	API Key	required
`action`	string	«add»	required
`service`	integer	Service ID	required
`link`	string	URL / order target	required
`quantity`	integer	Quantity (not required for Package type)	optional
`drip_feed`	boolean	Enable drip-feed (1 or 0)	optional
`runs`	integer	Number of runs (drip-feed)	optional
`interval`	integer	Interval in minutes (drip-feed)	optional
`comments`	string	Comments (Custom Comments)	optional
`usernames`	string	Mentions	optional
`hashtags`	string	Hashtags	optional
`answer_number`	integer	Answer number (Poll)	optional
`emoji`	string	Emoji string (Emoji)	optional

Request example

                                
POST https://palladium-smm.com/api/v2

key      = YOUR_API_KEY
action   = add
service  = 1
link     = https://instagram.com/user
quantity = 1000

{ "order": 12345 }

status Order status

action=status Get the status of one or multiple orders

Parameters

Parameter	Type	Description
`key`	string	API Key	required
`action`	string	«status»	required
`order`	integer	Single order ID	one of two
`orders`	string	Multiple IDs comma-separated: `1,2,3`	one of two

Single order

                                
{
  "charge": "1.50",
  "start_count": "850",
  "status": "In progress",
  "remains": "400",
  "currency": "USD"
}

Multiple orders

                                
{
  "1": {
    "charge": "1.50",
    "start_count": "0",
    "status": "Pending",
    "remains": "0",
    "currency": "USD"
  },
  "2": {
    "error": "Incorrect order ID"
  }
}

Status values

Pending In progress Completed Partial Canceled

cancel Cancel order

action=cancel Cancels the order and refunds the balance

Parameters

Parameter	Type	Description
`key`	string	API Key	required
`action`	string	«cancel»	required
`order`	integer	Single order ID	one of two
`orders`	string	Multiple IDs comma-separated	one of two

Single order

{ "cancel": 1 }

Multiple orders

                                
{
  "1": { "cancel": 1 },
  "3": {
    "error": "Order is already completed"
  }
}

refill Request Refill

action=refill Requests a refill for a completed order

Parameters

Parameter	Type	Description
`key`	string	API Key	required
`action`	string	«refill»	required
`order`	integer	Single order ID	one of two
`orders`	string	Multiple IDs comma-separated	one of two

Single order

{ "refill": 12345 }

Multiple orders

                                
{
  "1": { "refill": 101 },
  "2": {
    "error": "Refill is not available for this order"
  }
}

refill_status Refill Status

action=refill_status Checks the status of a refill request

Parameters

Parameter	Type	Description
`key`	string	API Key	required
`action`	string	«refill_status»	required
`refill`	integer	Refill request ID	one of two
`refills`	string	Multiple IDs comma-separated	one of two

{ "status": "Completed" }

Status values

"In progress"  — in progress
"Completed"    — completed
"Partial"      — partial
"Rejected"     — rejected

Service types

The type field of a service defines the set of additional parameters required when creating an order.

Type	Extra parameters	Description
`Default`	—	Default. Only `link` and `quantity`
`Custom Comments`	`comments`	List of comments, one per line
`Package`	—	Fixed package, `quantity` not needed
`Mentions`	`usernames`	List of @usernames, one per line
`Mentions with Hashtags`	`usernames`, `hashtags`	Mentions + Hashtags
`Hashtags`	`hashtags`	List of #hashtags, one per line
`Poll`	`answer_number`	Answer option number (starting from 1)
`Emoji`	`emoji`	Emoji string, e.g. `❤️🔥`

Errors

On error, the API always returns HTTP 200 with JSON containing the error key.

{ "error": "Incorrect API key" }

Message	Reason
`Incorrect API key`	Key not found or invalid
`Your account is banned`	Account is banned
`Incorrect action`	Unknown `action` value
`Incorrect parameters`	Missing `service` or `link`
`Incorrect service ID`	Service not found or disabled
`Incorrect order ID`	Order not found or belongs to another user
`Incorrect refill ID`	Refill request not found or belongs to another user
`Not enough funds on balance`	Insufficient funds
`Quantity must be between X and Y`	Quantity out of range
`Runs must be at least 1`	drip-feed: runs must be at least 1
`Interval must be at least 1 minute`	drip-feed: interval must be at least 1 minute
`Order is already completed`	Cannot cancel a completed order
`Refill is not available for this order`	Service does not support refill or order is not completed