概述

POST /v1/tx 是专用的异步交易提交端点。交易被接收后立即返回 HTTP 202 Accepted，由后台自动转发至 Robinhood Chain，并内置重试机制确保送达。

此端点专为追求极低提交延迟的场景设计，客户端感知延迟 < 5 ms。

与 /v1/rpc 的区别

特性	/v1/rpc	/v1/tx
模式	同步（等待链上响应）	异步（入队即返回 202）
支持方法	所有 JSON-RPC 方法	仅交易方法
响应	链上原始响应	提交确认
Content-Type	application/json	application/json 或 text/plain
配额	查询配额	交易配额（独立计费）

请求格式

POST /v1/tx
Content-Type: application/json 或 text/plain
X-User-ID: <your-api-key>

使用示例

JSON-RPC 格式

curl -X POST https://robinhood-ohio.flashblock.trade/v1/tx \
  -H "Content-Type: application/json" \
  -H "X-User-ID: <your-api-key>" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_sendRawTransaction",
    "params": ["0xf86c0a8502540be400825208943535..."],
    "id": 1
  }'

响应 (202 Accepted):

{
  "code": "accepted",
  "message": "transaction queued for submission",
  "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

原始 Hex 格式

支持直接发送已签名的原始交易 hex 字符串，无需包装为 JSON-RPC 格式：

curl -X POST https://robinhood-ohio.flashblock.trade/v1/tx \
  -H "Content-Type: text/plain" \
  -H "X-User-ID: <your-api-key>" \
  -d '0xf86c0a8502540be400825208943535...'

响应 (202 Accepted):

{
  "code": "accepted",
  "message": "transaction queued for submission",
  "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

支持的 Content-Type

Content-Type	行为
application/json	解析为标准 JSON-RPC 请求
text/plain	视为原始交易 hex，自动包装为 eth_sendRawTransaction
application/octet-stream	同 text/plain

支持的方法

此端点 仅接受 以下交易方法：

• eth_sendRawTransaction
• eth_sendTransaction

发送查询方法（如 eth_chainId、eth_getBalance）将返回 400 tx_method_required 错误。查询请求请使用 /v1/rpc 端点。

独立配额

交易端点 /v1/tx 与查询端点 /v1/rpc 使用 完全独立 的配额：

• 查询配额用尽时，交易提交仍然可用
• 交易配额用尽时，查询请求仍然可用
• 两者的 TPS 上限由您的套餐等级决定

详见 套餐与定价。