Free Fire ID Price Checker API Documentation

Welcome to the specialized documentation for the Free Fire ID Price Checker API. This API calculates the USD price of a Free Fire account based on key input parameters—such as level, diamondsSpent, elitePasses, rareItems, xp, and various counts—as well as player rank details. The final computed value reflects the overall account strength and is directly fetched from our external endpoint.

🚫 API usage is currently limited to 25 requests per day on the free plan. This includes all actions such as ban status checks, rank lookups, and related endpoints. To raise the limit and unlock features like advanced rank data, ban history details, and real-time moderation, consider upgrading your plan.

⚠️ The parameter subSec is not supported for the ID Price Checker API. This endpoint returns the full result object and does not support field-specific filtering. Please remove subSec from your API requests to avoid being ignored.

🚨 Security Warning: Never expose your useruid or api key directly in client-side code (such as HTML, JavaScript, or public repositories). These credentials are sensitive and must be securely stored and handled on your server. If exposed, anyone could misuse your account, exhaust your API limits, or access protected data on your behalf.

Endpoint Parameters

The following parameters are required for an ID Price Checker API request:

Parameter	Description
`level`	Player level as a number (e.g., `50`). Represents the player’s progression and contributes significantly to the account’s overall value.
`diamondsSpent`	Total diamonds spent by the player (e.g., `1000`). A measure of in-game purchases and investment.
`elitePasses`	Number of elite passes used (e.g., `2`). Indicates participation in special events or premium content.
`rareItems`	Count of rare items owned by the player (e.g., `3`). Rare items boost the valuation.
`xp`	Experience points earned (e.g., `50000`). The overall in-game XP enhances the calculated price.
`masterCount`	Number of master achievements (e.g., `4`). Reflects the number of successful milestones reached.
`eliteMasterCount`	Number of elite master achievements (e.g., `1`). Premium achievement level indicative of high skill.
`csMasterCount`	Count of Competitive Squad master ranks (e.g., `2`). Indicates performance in CS mode.
`csEliteMasterCount`	Count of Competitive Squad elite master ranks (e.g., `0`). Premium level count in CS mode.
`brRank`	Battle Royale rank (e.g., `gold`). See Supported Ranks below.
`csRank`	Competitive Squad rank (e.g., `silver`). See Supported Ranks below.
`sectionName`	Must be set to `IdPrice` to access this endpoint.
`PlayerUid`	Unique identifier of the player.
`useruid`	Your developer User ID, provided on your dashboard.
`api`	Your secret API key used for authentication.

Error Responses

{"error":"Missing required parameters"} – Occurs when any parameter is absent.
{"error":"Auth Failed! Please Check Your User ID & Try Again.."} – Invalid or missing useruid.
{"error":"Invalid API key. Obtain An official key form https://www.hlgamingofficial.com/p/api.html"} – When the API key is incorrect.
{"error":"Server error or external API issue. Try again later."} – For internal or external issues.

Supported Ranks

The API supports several rank parameters for both Battle Royale (BR) and Competitive Squad (CS) modes. Each rank is assigned a numerical value that contributes to the overall account valuation. Below is a detailed list of each supported rank:

Rank	Numerical Value	Description
`silver`	1	The starting tier; indicates basic skill level and entry into competitive play.
`gold`	2	Represents a higher skill level than silver and is a common milestone for dedicated players.
`platinum`	3	Denotes advanced performance, achieved after consistent high-level gameplay.
`diamond`	4	Indicates excellent performance; players here demonstrate mastery in multiple aspects of gameplay.
`heroic`	5	Reserved for players who have shown extraordinary skills and frequently win high-stakes matches.
`master`	6	This rank is awarded to players who continuously perform at the highest level and influence game strategies.
`elite-master`	7	The pinnacle rank, reflecting exceptional skill, experience, and an elite status among peers.

Note: The numerical values of these ranks from both brRank and csRank parameters are summed during the calculation process. This total directly influences the computed account value, ensuring that higher cumulative rank values yield a proportionately greater valuation.

Example API Request

To fetch the Free Fire ID Price, send a GET request using the following URL structure. Replace {PlayerUid}, {useruid}, and {api} with your actual credentials:

curl -X GET "https://hl-gaming-official-main-api.vercel.app/api?sectionName=IdPrice&PlayerUid={PlayerUid}&useruid={useruid}&api={api}&level=50&diamondsSpent=1000&elitePasses=2&rareItems=3&xp=50000&masterCount=4&eliteMasterCount=1&csMasterCount=2&csEliteMasterCount=0&brRank=gold&csRank=silver"

Example Output Response

A valid request returns a JSON response similar to the following:

{ "source": "HL Gaming Official", "endpoint": "IdPrice", "result": { "meta": { "apiName": "Free Fire Account Price API", "version": "1.0.0", "description": "Calculates the USD price of a Free Fire account based on input parameters.", "credits": "HL Gaming Official" }, "input": { "level": 50, "diamondsSpent": 1000, "elitePasses": 2, "rareItems": 3, "xp": 50000, "masterCount": 4, "eliteMasterCount": 1, "csMasterCount": 2, "csEliteMasterCount": 0, "brRank": "gold", "csRank": "silver", "currency": "USD" }, "calculation": { "accountValueUSD": "88.00", "computedAt": "2025-04-14T17:28:34.834Z" } }, "usage": { "usedToday": 16, "dailyLimit": 25, "remainingToday": 9 } }

Obtaining User UID and API Key

To access the API, you must have a valid developer user ID (useruid) and a corresponding secret API key (api). You can find step-by-step instructions on retrieving these credentials on our api.html page.

Credential	Description
`useruid`	Your unique developer user ID is assigned when you register on our platform. It is used to track your API usage and authenticate your requests.
`api`	Your secret API key is generated upon registration and is required for secure API access. This key should be kept confidential. For detailed instructions on obtaining or managing your API key, please refer to the api.html page.

API Usage Examples

Use the examples below to integrate the Free Fire ID Price Checker API into your applications:

🚫 API Usage Limit: Free plans are limited to 25 API requests per day. This includes all operations such as checking ban status, rank verification, and other related endpoints. To increase your request limit and unlock additional features such as advanced rank metadata, detailed ban history, and real-time moderation integration, please consider upgrading your plan.