Feel free to reach techsupport@surepass.io for any technical support or guidance.
Gold Price
Production
https://kyc-api.surepass.app
Production
https://kyc-api.surepass.app
GET
https://kyc-api.surepass.app
Description
Key Benefits
Use Cases
Financial Services
E-commerce & Retail
Fintech Applications
Technical Implementation
Authentication
All API requests require authentication using a JWT Bearer token. Authentication follows these steps:Obtain API Credentials: Register with Surepass to receive your API key. Generate JWT Token: Use your API key to generate a JWT token. Include in Requests: Add the token to the Different authentication tokens are used for sandbox and production environments: Sandbox: Production:
1.
2.
3.
Authorization header as Bearer TOKEN.https://sandbox.surepass.apphttps://kyc-api.surepass.appRequest Parameters
Request Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer JWT token for API authentication |
| Content-Type | No | application/json (recommended for consistency) |
Request Body
Process Response
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| data | object | Container object for all gold price data |
| data.client_id | string | Unique identifier for the API request |
| data.carat_24 | string | Current price for 24-carat gold (gold999) |
| data.carat_22 | string | Current price for 22-carat gold (gold916) |
| data.carat_18 | string | Current price for 18-carat gold (gold750) |
| data.today_opening_price | object | Gold prices at market opening for the current day |
| data.today_opening_price.carat_24 | string | Opening price for 24-carat gold |
| data.today_opening_price.carat_22 | string | Opening price for 22-carat gold |
| data.today_opening_price.carat_18 | string | Opening price for 18-carat gold |
| data.today_opening_price.has_updated | boolean | Indicates if opening prices have been updated |
| data.today_closing_price | object | Gold prices at market closing for the current day |
| data.today_closing_price.carat_24 | string | Closing price for 24-carat gold |
| data.today_closing_price.carat_22 | string | Closing price for 22-carat gold |
| data.today_closing_price.carat_18 | string | Closing price for 18-carat gold |
| data.today_closing_price.has_updated | boolean | Indicates if closing prices have been updated |
| data.last_30_days_average_price | object | Average gold prices over the last 30 days |
| data.last_30_days_average_price.carat_24_avg | string | 30-day average for 24-carat gold |
| data.last_30_days_average_price.carat_22_avg | string | 30-day average for 22-carat gold |
| data.last_30_days_average_price.carat_18_avg | string | 30-day average for 18-carat gold |
| data.last_30_days_closing_price | object | Historical closing prices for the last 30 days |
| data.last_30_days_closing_price.pm_prices | object | Afternoon/closing prices organized by gold purity |
| data.last_30_days_closing_price.pm_prices.gold999 | object | 24K gold PM prices (date: price pairs) |
| data.last_30_days_closing_price.pm_prices.gold916 | object | 22K gold PM prices (date: price pairs) |
| data.last_30_days_closing_price.pm_prices.gold750 | object | 18K gold PM prices (date: price pairs) |
| data.last_30_days_closing_price.am_prices | object | Morning/opening prices organized by gold purity |
| data.last_30_days_closing_price.am_prices.gold999 | object | 24K gold AM prices (date: price pairs) |
| data.last_30_days_closing_price.am_prices.gold916 | object | 22K gold AM prices (date: price pairs) |
| data.last_30_days_closing_price.am_prices.gold750 | object | 18K gold AM prices (date: price pairs) |
| status_code | integer | HTTP status code of the response |
| success | boolean | Indicates whether the API call was successful |
| message | string | Human-readable message describing the response |
| message_code | string | Machine-readable message code |
Example Successful Response
{
"data": {
"client_id": "gold_price_rbpzPfQyvCYcaPJEDjzi",
"carat_24": "12785",
"carat_22": "11711",
"carat_18": "9588",
"today_opening_price": {
"carat_24": "12776",
"carat_22": "11702",
"carat_18": "9582",
"has_updated": true
},
"today_closing_price": {
"carat_24": "12784",
"carat_22": "11711",
"carat_18": "9588",
"has_updated": true
},
"last_30_days_average_price": {
"carat_24_avg": "12345",
"carat_22_avg": "11308",
"carat_18_avg": "9265"
},
"last_30_days_closing_price": {
"pm_prices": {
"gold999": {
"2025-10-23": "12335",
"2025-10-24": "12152",
"2025-10-27": "12108",
"2025-10-28": "11804",
"2025-10-29": "12063",
"2025-10-30": "11962",
"2025-10-31": "12077",
"2025-11-03": "12078",
"2025-11-04": "12042",
"2025-11-06": "12067",
"2025-11-07": "12010",
"2025-11-10": "12244",
"2025-11-11": "12415",
"2025-11-12": "12391",
"2025-11-13": "12655",
"2025-11-14": "12479",
"2025-11-17": "12292",
"2025-11-18": "12218",
"2025-11-19": "12388",
"2025-11-20": "12256",
"2025-11-21": "12315",
"2025-11-24": "12331",
"2025-11-25": "12512",
"2025-11-26": "12608",
"2025-11-27": "12606",
"2025-11-28": "12659",
"2025-12-01": "12880",
"2025-12-02": "12759",
"2025-12-03": "12821",
"2025-12-04": "12784"
},
"gold916": {
"2025-10-23": "11299",
"2025-10-24": "11131",
"2025-10-27": "11091",
"2025-10-28": "10813",
"2025-10-29": "11050",
"2025-10-30": "10957",
"2025-10-31": "11062",
"2025-11-03": "11063",
"2025-11-04": "11030",
"2025-11-06": "11053",
"2025-11-07": "11001",
"2025-11-10": "11216",
"2025-11-11": "11372",
"2025-11-12": "11350",
"2025-11-13": "11592",
"2025-11-14": "11431",
"2025-11-17": "11260",
"2025-11-18": "11192",
"2025-11-19": "11348",
"2025-11-20": "11227",
"2025-11-21": "11280",
"2025-11-24": "11295",
"2025-11-25": "11461",
"2025-11-26": "11549",
"2025-11-27": "11547",
"2025-11-28": "11596",
"2025-12-01": "11798",
"2025-12-02": "11688",
"2025-12-03": "11744",
"2025-12-04": "11711"
},
"gold750": {
"2025-10-23": "9252",
"2025-10-24": "9114",
"2025-10-27": "9081",
"2025-10-28": "8853",
"2025-10-29": "9047",
"2025-10-30": "8971",
"2025-10-31": "9058",
"2025-11-03": "9258",
"2025-11-04": "9031",
"2025-11-06": "9050",
"2025-11-07": "9008",
"2025-11-10": "9183",
"2025-11-11": "9311",
"2025-11-12": "9294",
"2025-11-13": "9492",
"2025-11-14": "9360",
"2025-11-17": "9219",
"2025-11-18": "9164",
"2025-11-19": "9291",
"2025-11-20": "9192",
"2025-11-21": "9236",
"2025-11-24": "9248",
"2025-11-25": "9384",
"2025-11-26": "9456",
"2025-11-27": "9454",
"2025-11-28": "9494",
"2025-12-01": "9660",
"2025-12-02": "9570",
"2025-12-03": "9616",
"2025-12-04": "9588"
}
},
"am_prices": {
"gold999": {
"2025-10-23": "12383",
"2025-10-24": "12242",
"2025-10-27": "12240",
"2025-10-28": "11916",
"2025-10-29": "11935",
"2025-10-30": "11925",
"2025-10-31": "12082",
"2025-11-03": "12111",
"2025-11-04": "11992",
"2025-11-06": "12010",
"2025-11-07": "12023",
"2025-11-10": "12209",
"2025-11-11": "12415",
"2025-11-12": "12336",
"2025-11-13": "12612",
"2025-11-14": "12543",
"2025-11-17": "12271",
"2025-11-18": "12137",
"2025-11-19": "12345",
"2025-11-20": "12288",
"2025-11-21": "12215",
"2025-11-24": "12306",
"2025-11-25": "12534",
"2025-11-26": "12600",
"2025-11-27": "12586",
"2025-11-28": "12667",
"2025-12-01": "12860",
"2025-12-02": "12814",
"2025-12-03": "12855",
"2025-12-04": "12776"
},
"gold916": {
"2025-10-23": "11343",
"2025-10-24": "11214",
"2025-10-27": "11212",
"2025-10-28": "10915",
"2025-10-29": "10933",
"2025-10-30": "10924",
"2025-10-31": "11067",
"2025-11-03": "11094",
"2025-11-04": "10984",
"2025-11-06": "11001",
"2025-11-07": "11013",
"2025-11-10": "11183",
"2025-11-11": "11372",
"2025-11-12": "11300",
"2025-11-13": "11553",
"2025-11-14": "11489",
"2025-11-17": "11241",
"2025-11-18": "11117",
"2025-11-19": "11308",
"2025-11-20": "11256",
"2025-11-21": "11189",
"2025-11-24": "11272",
"2025-11-25": "11481",
"2025-11-26": "11542",
"2025-11-27": "11528",
"2025-11-28": "11603",
"2025-12-01": "11780",
"2025-12-02": "11738",
"2025-12-03": "11775",
"2025-12-04": "11702"
},
"gold750": {
"2025-10-23": "9287",
"2025-10-24": "9181",
"2025-10-27": "9180",
"2025-10-28": "8937",
"2025-10-29": "8951",
"2025-10-30": "8944",
"2025-10-31": "9061",
"2025-11-03": "9084",
"2025-11-04": "8994",
"2025-11-06": "9008",
"2025-11-07": "9017",
"2025-11-10": "9156",
"2025-11-11": "9311",
"2025-11-12": "9252",
"2025-11-13": "9459",
"2025-11-14": "9407",
"2025-11-17": "9204",
"2025-11-18": "9102",
"2025-11-19": "9259",
"2025-11-20": "9216",
"2025-11-21": "9161",
"2025-11-24": "9229",
"2025-11-25": "9401",
"2025-11-26": "9450",
"2025-11-27": "9439",
"2025-11-28": "9500",
"2025-12-01": "9645",
"2025-12-02": "9611",
"2025-12-03": "9641",
"2025-12-04": "9582"
}
}
}
},
"status_code": 200,
"success": true,
"message": "Success",
"message_code": "success"
}Possible Error Responses
Authentication Error
{
"status_code": 401,
"success": false,
"message": "Invalid or expired authentication token",
"message_code": "auth_error"
}Integration Best Practices
Security Recommendations
User Experience Guidelines
Code Samples
cURL
Python
Node.js
Compliance and Legal Considerations
Request
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://kyc-api.surepass.app/api/v1/utilities/gold-price' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"data": {
"client_id": "gold_price_rbpzPfQyvCYcaPJEDjzi",
"carat_24": "12785",
"carat_22": "11711",
"carat_18": "9588",
"today_opening_price": {
"carat_24": "12776",
"carat_22": "11702",
"carat_18": "9582",
"has_updated": true
},
"today_closing_price": {
"carat_24": "12784",
"carat_22": "11711",
"carat_18": "9588",
"has_updated": true
},
"last_30_days_average_price": {
"carat_24_avg": "12345",
"carat_22_avg": "11308",
"carat_18_avg": "9265"
},
"last_30_days_closing_price": {
"pm_prices": {
"gold999": {
"2025-10-23": "12335",
"2025-10-24": "12152",
"2025-10-27": "12108",
"2025-10-28": "11804",
"2025-10-29": "12063",
"2025-10-30": "11962",
"2025-10-31": "12077",
"2025-11-03": "12078",
"2025-11-04": "12042",
"2025-11-06": "12067",
"2025-11-07": "12010",
"2025-11-10": "12244",
"2025-11-11": "12415",
"2025-11-12": "12391",
"2025-11-13": "12655",
"2025-11-14": "12479",
"2025-11-17": "12292",
"2025-11-18": "12218",
"2025-11-19": "12388",
"2025-11-20": "12256",
"2025-11-21": "12315",
"2025-11-24": "12331",
"2025-11-25": "12512",
"2025-11-26": "12608",
"2025-11-27": "12606",
"2025-11-28": "12659",
"2025-12-01": "12880",
"2025-12-02": "12759",
"2025-12-03": "12821",
"2025-12-04": "12784"
},
"gold916": {
"2025-10-23": "11299",
"2025-10-24": "11131",
"2025-10-27": "11091",
"2025-10-28": "10813",
"2025-10-29": "11050",
"2025-10-30": "10957",
"2025-10-31": "11062",
"2025-11-03": "11063",
"2025-11-04": "11030",
"2025-11-06": "11053",
"2025-11-07": "11001",
"2025-11-10": "11216",
"2025-11-11": "11372",
"2025-11-12": "11350",
"2025-11-13": "11592",
"2025-11-14": "11431",
"2025-11-17": "11260",
"2025-11-18": "11192",
"2025-11-19": "11348",
"2025-11-20": "11227",
"2025-11-21": "11280",
"2025-11-24": "11295",
"2025-11-25": "11461",
"2025-11-26": "11549",
"2025-11-27": "11547",
"2025-11-28": "11596",
"2025-12-01": "11798",
"2025-12-02": "11688",
"2025-12-03": "11744",
"2025-12-04": "11711"
},
"gold750": {
"2025-10-23": "9252",
"2025-10-24": "9114",
"2025-10-27": "9081",
"2025-10-28": "8853",
"2025-10-29": "9047",
"2025-10-30": "8971",
"2025-10-31": "9058",
"2025-11-03": "9258",
"2025-11-04": "9031",
"2025-11-06": "9050",
"2025-11-07": "9008",
"2025-11-10": "9183",
"2025-11-11": "9311",
"2025-11-12": "9294",
"2025-11-13": "9492",
"2025-11-14": "9360",
"2025-11-17": "9219",
"2025-11-18": "9164",
"2025-11-19": "9291",
"2025-11-20": "9192",
"2025-11-21": "9236",
"2025-11-24": "9248",
"2025-11-25": "9384",
"2025-11-26": "9456",
"2025-11-27": "9454",
"2025-11-28": "9494",
"2025-12-01": "9660",
"2025-12-02": "9570",
"2025-12-03": "9616",
"2025-12-04": "9588"
}
},
"am_prices": {
"gold999": {
"2025-10-23": "12383",
"2025-10-24": "12242",
"2025-10-27": "12240",
"2025-10-28": "11916",
"2025-10-29": "11935",
"2025-10-30": "11925",
"2025-10-31": "12082",
"2025-11-03": "12111",
"2025-11-04": "11992",
"2025-11-06": "12010",
"2025-11-07": "12023",
"2025-11-10": "12209",
"2025-11-11": "12415",
"2025-11-12": "12336",
"2025-11-13": "12612",
"2025-11-14": "12543",
"2025-11-17": "12271",
"2025-11-18": "12137",
"2025-11-19": "12345",
"2025-11-20": "12288",
"2025-11-21": "12215",
"2025-11-24": "12306",
"2025-11-25": "12534",
"2025-11-26": "12600",
"2025-11-27": "12586",
"2025-11-28": "12667",
"2025-12-01": "12860",
"2025-12-02": "12814",
"2025-12-03": "12855",
"2025-12-04": "12776"
},
"gold916": {
"2025-10-23": "11343",
"2025-10-24": "11214",
"2025-10-27": "11212",
"2025-10-28": "10915",
"2025-10-29": "10933",
"2025-10-30": "10924",
"2025-10-31": "11067",
"2025-11-03": "11094",
"2025-11-04": "10984",
"2025-11-06": "11001",
"2025-11-07": "11013",
"2025-11-10": "11183",
"2025-11-11": "11372",
"2025-11-12": "11300",
"2025-11-13": "11553",
"2025-11-14": "11489",
"2025-11-17": "11241",
"2025-11-18": "11117",
"2025-11-19": "11308",
"2025-11-20": "11256",
"2025-11-21": "11189",
"2025-11-24": "11272",
"2025-11-25": "11481",
"2025-11-26": "11542",
"2025-11-27": "11528",
"2025-11-28": "11603",
"2025-12-01": "11780",
"2025-12-02": "11738",
"2025-12-03": "11775",
"2025-12-04": "11702"
},
"gold750": {
"2025-10-23": "9287",
"2025-10-24": "9181",
"2025-10-27": "9180",
"2025-10-28": "8937",
"2025-10-29": "8951",
"2025-10-30": "8944",
"2025-10-31": "9061",
"2025-11-03": "9084",
"2025-11-04": "8994",
"2025-11-06": "9008",
"2025-11-07": "9017",
"2025-11-10": "9156",
"2025-11-11": "9311",
"2025-11-12": "9252",
"2025-11-13": "9459",
"2025-11-14": "9407",
"2025-11-17": "9204",
"2025-11-18": "9102",
"2025-11-19": "9259",
"2025-11-20": "9216",
"2025-11-21": "9161",
"2025-11-24": "9229",
"2025-11-25": "9401",
"2025-11-26": "9450",
"2025-11-27": "9439",
"2025-11-28": "9500",
"2025-12-01": "9645",
"2025-12-02": "9611",
"2025-12-03": "9641",
"2025-12-04": "9582"
}
}
}
},
"status_code": 200,
"success": true,
"message": "Success",
"message_code": "success"
}