> For the complete documentation index, see [llms.txt](https://node1.gitbook.io/node1-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://node1.gitbook.io/node1-docs/documentation/zh/solana/fast-landing/http-api.md).

# HTTP 交易提交

## 概览

* **基础 URL:** 使用[区域节点地址](/node1-docs/documentation/zh/solana/fast-landing/endpoints.md)，例如 `https://ny.node1.me`。
* **认证:** 请求头中需加入 API 密钥，部分小费相关端点除外。
* **数据格式:** JSON-RPC 请求使用 JSON，而 HTTP V2 直接接收 bincode::serialize(\&vtx) 产生的原始二进制。

## 认证方式

请在请求头中加入 API 密钥：

`api-key: YOUR_ACCOUNT_UUID`

访问 <https://node1.me> 创建账号后会自动生成 Account UUID，并开通 2 TPS 的 Solana 交易上链服务。可直接将 UUID 作为 API 密钥；更高 TPS 请前往 Discord 申请。

## 发送交易

### 🔗 JSON-RPC 2.0 提交

● cURL 示例:

```bash
curl -X POST "https://ny.node1.me" \
-H "Content-Type: application/json" \
-H "api-key: YOUR_ACCOUNT_UUID" \
-d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "sendTransaction",
  "params": [
    "YOUR_BASE64_ENCODED_TRANSACTION"
  ]
}'
```

● 成功响应:

```json
{
  "jsonrpc": "2.0",
  "result": "5XHA7ofPAf3FaLUAY3kT52c...",
  "id": 1
}
```

### ⚡ HTTP V2 原始二进制提交

将序列化后的 VersionedTransaction 二进制直接发送到区域 /v2 端点。请保留 api-key 请求头，并将 bincode::serialize(\&vtx) 的结果作为请求体。

`端点示例：http://fra.node1.me/v2`

● Rust 示例:

```rust
let send_result = client.post("http://fra.node1.me/v2")
    .header("api-key", "YOUR_ACCOUNT_UUID")
    .body(bincode::serialize(&vtx).unwrap())
    .send().await;
```


---

# 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://node1.gitbook.io/node1-docs/documentation/zh/solana/fast-landing/http-api.md?ask=<question>&goal=<endgoal>
```

`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.