> For the complete documentation index, see [llms.txt](https://docs.tronsave.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tronsave.io/chinese/developers/api-reference/buy-resources/api-key/get-account-info.md).
# 获取账户信息
获取与所提供 API 密钥关联的内部账户信息，包括账户 `id`、当前以 SUN 计的 `balance`、在订单中代表该账户的地址，以及用于充值 TRX 的地址。
## 端点
**`GET`** **`https://api.tronsave.io/v2/user-info`**
{% hint style="info" %}
**速率限制：** 每 1 秒 15 次请求。
{% endhint %}
## 请求头
### 200: OK
```json
{
"error": false,
"message": "Success",
"data": {
"id": string, //internal account id
"balance": string, //internal account balance in SUN
"representAddress": string, //represents the internal account as the requester of the order
"depositAddress": string, //Send TRX to this address to deposit into your internal account.
}
}
```
### 成功响应示例
```json
{
"error": false,
"message": "Success",
"data": {
"id": "user_id",
"balance": "306773887",
"representAddress": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999",
"depositAddress": "TKVSaJQDWeKFSEXmA44pjxduGTxy999999"
}
}
```
### 错误
此端点使用 `apikey` 请求头进行身份验证，因此常见错误为身份验证失败。
**401 Unauthorized —— 缺少 API 密钥**（未发送 `apikey` 请求头）：
```json
{
"error": true,
"message": "TSAS:106 API_KEY_REQUIRED",
"data": null
}
```
**401 Unauthorized —— 无效的 API 密钥**：
```json
{
"error": true,
"message": "TSAS:107 INVALID_API_KEY",
"data": null
}
```
## 请求示例
{% tabs %}
{% tab title="cURL" %}
```bash
curl -X GET "https://api.tronsave.io/v2/user-info" \
-H "apikey: YOUR_API_KEY"
```
{% endtab %}
{% tab title="JavaScript" %}
```javascript
const TRONSAVE_API_URL = "https://api.tronsave.io";
const getAccountInfo = async (apiKey) => {
const url = `${TRONSAVE_API_URL}/v2/user-info`;
const res = await fetch(url, {
headers: {
apikey: apiKey,
},
});
return res.json();
};
getAccountInfo("YOUR_API_KEY").then(console.log);
```
{% endtab %}
{% tab title="Python" %}
```python
import requests
TRONSAVE_API_URL = "https://api.tronsave.io"
API_KEY = "YOUR_API_KEY"
def get_account_info() -> dict:
"""Get internal account information."""
url = f"{TRONSAVE_API_URL}/v2/user-info"
headers = {"apikey": API_KEY}
response = requests.get(url, headers=headers)
return response.json()
print(get_account_info())
```
{% endtab %}
{% tab title="Java" %}
```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class GetAccountInfo {
static final String TRONSAVE_API_URL = "https://api.tronsave.io";
static final String API_KEY = "YOUR_API_KEY";
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(TRONSAVE_API_URL + "/v2/user-info"))
.header("apikey", API_KEY)
.GET()
.build();
HttpResponse response =
client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
```
{% endtab %}
{% tab title="Go" %}
```go
package main
import (
"fmt"
"io"
"net/http"
)
const (
tronsaveAPIURL = "https://api.tronsave.io"
apiKey = "YOUR_API_KEY"
)
func main() {
req, err := http.NewRequest(http.MethodGet, tronsaveAPIURL+"/v2/user-info", nil)
if err != nil {
panic(err)
}
req.Header.Set("apikey", apiKey)
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
```
{% endtab %}
{% tab title="Rust" %}
```rust
use serde_json::Value;
const TRONSAVE_API_URL: &str = "https://api.tronsave.io";
const API_KEY: &str = "YOUR_API_KEY";
fn main() -> Result<(), Box> {
let client = reqwest::blocking::Client::new();
let resp: Value = client
.get(format!("{TRONSAVE_API_URL}/v2/user-info"))
.header("apikey", API_KEY)
.send()?
.json()?;
println!("{resp:#?}");
Ok(())
}
```
{% endtab %}
{% endtabs %}
## 后续步骤
* [获取订单簿](/chinese/developers/api-reference/buy-resources/api-key/get-order-book.md) —— 获取当前的资源价格和可用情况。
* [购买能量（创建订单）](/chinese/developers/api-reference/buy-resources/api-key/create-order.md) —— 下单并从你的内部账户付款。
* [身份验证](/chinese/developers/authentication.md) —— 如何在每次请求时传入你的 API 密钥。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.tronsave.io/chinese/developers/api-reference/buy-resources/api-key/get-account-info.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.