基本信息
接口名称:
今日黄金价格
请求方法:
GET
计费类型:
免费
接口文档
# 金价查询代理 API 文档
接口地址:`https://api.logoi.cn/api/goldprice`
---
## 1. 基础信息
| 项 | 说明 |
| ----------- | ------------------------------------ |
| 接口地址 | `https://api.logoi.cn/api/goldprice` |
| 请求方式 | GET / POST 均可 |
| 返回格式 | JSON |
| 字符编码 | UTF-8 |
| 签名 / 鉴权 | 无 |
---
## 2. 请求参数
**无参数** —— 直接调用即可。
---
## 3. 返回字段
| 字段名 | 类型 | 说明 |
| --------------------- | ------ | ------------------ |
| code | int | 状态码,`200` 成功 |
| msg | string | 状态描述 |
| data | object | 数据 |
| data.time | string | 行情更新时间 |
| data.price | string | 今日价格(元/克) |
| data.dir | string | 黄金目录 |
| data.title | string | 黄金名称 |
| data.changepercent | string | 涨跌幅(%) |
| data.maxprice | string | 最高价 |
| data.minprice | string | 最低价 |
| data.openingprice | string | 开盘价 |
| data.lastclosingprice | string | 昨收价 |
| data.date | string | 日期 |
---
## 4. 正确示例
**请求**
```
GET https://api.logoi.cn/api/goldprice
```
**返回**
```json
200
{
"code": 200,
"msg": "获取成功",
"data": {
"code": 200,
"msg": "获取成功",
"time": "2025-09-18",
"price": "823.01",
"data": [
{
"id": "1",
"dir": "au9999",
"title": "AU9999",
"price": "823.28",
"changepercent": "-1.03",
"maxprice": "837.00",
"minprice": "822.00",
"openingprice": "832.80",
"lastclosingprice": "831.85",
"date": "2025-09-18"
},
{
"id": "2",
"dir": "daygold",
"title": "黄金延期",
"price": "823.01",
"changepercent": "-1.40",
"maxprice": "835.60",
"minprice": "821.87",
"openingprice": "830.55",
"lastclosingprice": "830.25",
"date": "2025-09-18"
},
{
"id": "3",
"dir": "goldprice",
"title": "迷你黄金延期",
"price": "823.44",
"changepercent": "-1.31",
"maxprice": "836.77",
"minprice": "822.00",
"openingprice": "831.00",
"lastclosingprice": "832.03",
"date": "2025-09-18"
},
{
"id": "4",
"dir": "au9995",
"title": "沪金95",
"price": "822.80",
"changepercent": "-1.11",
"maxprice": "826.20",
"minprice": "822.80",
"openingprice": "826.20",
"lastclosingprice": "832.00",
"date": "2025-09-18"
},
{
"id": "5",
"dir": "pt9995",
"title": "沪铂95",
"price": "323.60",
"changepercent": "-1.30",
"maxprice": "325.05",
"minprice": "321.77",
"openingprice": "321.77",
"lastclosingprice": "327.85",
"date": "2025-09-18"
},
{
"id": "6",
"dir": "au100g",
"title": "沪金100G",
"price": "824.00",
"changepercent": "-1.12",
"maxprice": "831.70",
"minprice": "824.00",
"openingprice": "831.00",
"lastclosingprice": "833.30",
"date": "2025-09-18"
},
{
"id": "7",
"dir": "autn1",
"title": "延期单金",
"price": "568.60",
"changepercent": "0.00",
"maxprice": "0.00",
"minprice": "0.00",
"openingprice": "0.00",
"lastclosingprice": "568.60",
"date": "2025-09-18"
},
{
"id": "8",
"dir": "autn2",
"title": "延期双金",
"price": "679.00",
"changepercent": "6.26",
"maxprice": "679.00",
"minprice": "679.00",
"openingprice": "679.00",
"lastclosingprice": "639.00",
"date": "2025-09-18"
}
]
},
"api_source": "官方API网:https://api.logoi.cn/"
}
```
---
## 5. 错误码
| HTTP 状态 | code | 含义说明 |
| --------- | ---- | ------------------ |
| 503 | ≠200 | 上游网络或解析异常 |
| 500 | — | 本机网络错误 |
---
## 6. 调用限制
- 免费,无需注册
---
## 7. 快速调试
```bash
curl https://api.logoi.cn/api/goldprice
```
请求参数
| 参数名 | 是否必填 | 类型 | 参数说明 | 示例值 |
|---|
请求示例
[]
返回参数
| 参数名 | 类型 | 说明 |
|---|
返回示例
[]