API documentation

The stock files are served through a simple, public HTTP API. Lines you fetch are removed from the stored files.

Base URL

https://3rdmarket.online/

Authentication

Every request requires an API key. An admin creates a one-use registration key; a new member claims it during sign-up, and it becomes their API key. Members can replace it in settings. Keys cannot be created through the API. Pass the key either as a query parameter or an X-Api-Key header:

api/?api_key=3rdm_YOUR_KEY&stock=tiktok&size=100

X-Api-Key: 3rdm_YOUR_KEY
GET api/?stock=tiktok&size=100

Endpoints

List all stock folders

GET api/?api_key={key}&action=stocks

Returns every stock folder with its number of .txt files and total available lines. Also accepted as action=list.

{
  "stocks": [
    { "stock": "roblox", "files": 2, "lines": 3400 },
    { "stock": "tiktok", "files": 1, "lines": 100 }
  ]
}

Get / consume lines from a stock

GET api/?api_key={key}&stock={folder-name}&size={how many lines}

Returns the requested number of lines (accounts) from the folder's .txt files and deletes those lines from the files. Lines are pulled from the folder's files in alphabetical order, moving to the next file when one runs out.

Query parameters

Parameter	Required	Default	Description
`api_key`	Yes	—	API key assigned to your account during registration or by an admin. Also accepted as the `X-Api-Key` header.
`stock`	Yes	—	Name of the stock folder to take lines from.
`size`	No	`1`	How many lines to fetch and remove. Must be 1 or more.

Tip: both & and ? separators are accepted (e.g. api/?stock=roblox?size=5 works too).

Examples

Fetch 100 lines from the "tiktok" stock

GET api/?api_key=3rdm_YOUR_KEY&stock=tiktok&size=100

Response

{
  "stock": "tiktok",
  "file": "TIKTOK-PREMIUM-6332155141-1763225816532.txt",
  "size": 100,
  "lines": [
    "ahnaf_senpai:JwCQKGU-MF24NR.",
    "the121571@gmail.com:KigaliSamson2023"
  ]
}

Fetch a single line

GET api/?api_key=3rdm_YOUR_KEY&stock=roblox

Usage tracking

Each successful call increments the key's Requests counter, and the number of lines returned is added to its Lines counter. Totals are visible on the admin API key management page.

Error responses

Status	Body	When
`401`	`{"error":"Invalid or missing API key."}`	The API key is missing, revoked, or unknown.
`404`	`{"error":"Stock not found."}`	The stock folder does not exist.
`400`	`{"error":"size must be a positive number of lines."}`	`size` is missing, zero, or negative.

Notes

If the folder has fewer lines than size, all remaining lines are returned.
If the folder is empty, the response has an empty lines array.
Consumed lines are permanently removed from the stored .txt files.