> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentwallex.com/llms.txt
> Use this file to discover all available pages before exploring further.
# トランザクションの取得
> オンチェーンハッシュと確認ステータスを含む単一のトランザクションをIDで取得します。
オンチェーンハッシュ、金額、トークン、手数料、現在のステータスを含む単一のトランザクションの完全な詳細を取得します。
## パスパラメータ
一意のトランザクション識別子（例：`tx_xyz789`）。
## レスポンス
一意のトランザクション識別子。
オンチェーントランザクションハッシュ。
トランザクションを開始したエージェント。
トランザクションの方向：`outbound`。
トランザクションタイプ：`transfer`。
送信元アドレス。
受取人アドレス。
送信された金額。
トークンシンボル。
CAIP-2チェーン識別子。
支払われたネットワークガス手数料。
現在のステータス：`pending`、`confirmed`、`failed`。
オプションのメモ文字列。
ISO 8601作成タイムスタンプ。
## 例
```bash cURL theme={null}
curl -X GET https://api.agentwallex.com/api/v1/transactions/tx_xyz789 \
-H "X-API-Key: awx_your_api_key"
```
```typescript TypeScript theme={null}
const tx = await aw.payments.get("tx_xyz789");
```
```python Python theme={null}
tx = await aw.payments.get("tx_xyz789")
```
```json Response theme={null}
{
"id": "tx_xyz789",
"hash": "0xabc123def456789abc123def456789abc123def456789abc123def456789abcd",
"agent_id": "agent_abc123",
"direction": "outbound",
"type": "transfer",
"from_address": "0x1234567890abcdef1234567890abcdef12345678",
"to_address": "0xabcdef1234567890abcdef1234567890abcdef12",
"amount": "10.5",
"token": "USDC",
"chain": "eip155:84532",
"fee": "0.001",
"status": "confirmed",
"memo": "service payment",
"created_at": "2025-06-15T14:30:00Z"
}
```
## OpenAPI
````yaml GET /api/v1/transactions/{id}
openapi: 3.1.0
info:
title: AgentWallex API
description: >-
REST API for managing AI agent wallets, on-chain transactions, spending
policies, webhooks, and x402 micropayments.
version: 1.0.0
contact:
name: AgentWallex Support
url: https://agentwallex.com
servers:
- url: https://api.agentwallex.com
description: Production
- url: https://api-sandbox.agentwallex.com
description: Sandbox
security:
- ApiKeyAuth: []
- BearerAuth: []
tags:
- name: Agents
description: Create and manage AI agent wallets.
- name: Transactions
description: Send payments and query transaction history.
- name: Policies
description: Configure spending limits and access controls.
- name: Webhooks
description: Register and manage webhook endpoints.
- name: x402
description: x402 micropayment negotiation and session management.
paths:
/api/v1/transactions/{id}:
get:
tags:
- Transactions
summary: Get Transaction
description: >-
Retrieve the full details of a single transaction, including on-chain
hash, amount, token, fees, and current status.
operationId: getTransaction
parameters:
- name: id
in: path
required: true
description: The unique transaction identifier (e.g., `tx_xyz789`).
schema:
type: string
responses:
'200':
description: Transaction details.
content:
application/json:
schema:
$ref: '#/components/schemas/Transaction'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
components:
schemas:
Transaction:
type: object
description: An on-chain transaction submitted through an agent's wallet.
properties:
id:
type: string
description: Unique transaction identifier.
hash:
type: string
description: On-chain transaction hash (available after broadcast).
agent_id:
type: string
description: Agent that initiated the transaction.
direction:
type: string
enum:
- outbound
description: Transaction direction.
type:
type: string
enum:
- transfer
description: Transaction type.
from_address:
type: string
description: Sender address.
to_address:
type: string
description: Recipient address.
amount:
type: string
description: Amount sent as a decimal string.
token:
type: string
description: Token symbol (e.g., `USDC`, `USDT`, `ETH`).
chain:
type: string
description: CAIP-2 chain identifier.
fee:
type: string
description: Network gas fee paid.
status:
type: string
enum:
- pending
- confirmed
- failed
description: Transaction status.
memo:
type: string
description: Optional memo string.
created_at:
type: string
format: date-time
description: ISO 8601 creation timestamp.
ErrorResponse:
type: object
description: Standard error response.
required:
- code
- type
- message
properties:
code:
type: string
description: Machine-readable error code.
type:
type: string
enum:
- invalid_request_error
- authentication_error
- authorization_error
- not_found_error
- rate_limit_error
- internal_error
description: Error type category.
message:
type: string
description: Human-readable error description.
responses:
Unauthorized:
description: Missing or invalid credentials.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
code: authentication_failed
type: authentication_error
message: The provided API key is invalid or expired.
Forbidden:
description: Insufficient permissions.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
code: insufficient_permissions
type: authorization_error
message: You do not have permission to perform this action.
NotFound:
description: Resource does not exist.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
code: resource_not_found
type: not_found_error
message: The requested resource was not found.
RateLimited:
description: Rate limit exceeded.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
code: rate_limit_exceeded
type: rate_limit_error
message: Too many requests. Please retry after a short delay.
InternalError:
description: Server-side error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
code: server_error
type: internal_error
message: An unexpected error occurred. Please try again later.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: API key authentication. Keys are prefixed with `awx_`.
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: JWT bearer token authentication.
````