> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 解析されたイベントクイックスタート
> 最初のトランザクションを解析し、解析されたアドレス履歴を取得し、結果をページネートします。両方のエンドポイントのRESTリファレンスもあります。
解析されたイベントを初めて使用しますか？ まず、解析されたストリームの[メンタルモデル](/docs/ja/parsed-streams#the-mental-model)を読んでください — 解析されたイベントは、RESTとGraphQLを通じて同じデコードされた命令を返します。
## クイックスタート
解析されたイベントはクローズドベータです。 プロジェクトで有効になっていることを確認してください。クローズドベータに参加するには、[こちらに申し込む](https://form.typeform.com/to/BlFWKbC9)ください。
APIキーをプロジェクトに認証し、クエリパラメータとして`api-key`を渡します。
署名を`transactions`のボディフィールドに渡します:
```javascript theme={"system"}
const parseTransactions = async () => {
const url = "https:///transactions?api-key=YOUR_API_KEY";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
transactions: [
"5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
],
includeRawTransaction: false,
}),
});
const data = await response.json();
console.log(data);
};
parseTransactions();
```
```bash theme={"system"}
curl -X POST "https:///transactions?api-key=YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"transactions": [
"5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH"
],
"includeRawTransaction": false
}'
```
レスポンスは、要求された各署名に対して1つの結果を含み、入力順に並びます。各結果には`signature`、`parserStatus`、および`parsed`または`parserError`のいずれかが含まれます:
```json [expandable] theme={"system"}
[
{
"signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
"parserStatus": "OK",
"parsed": {
"slot": 433950192,
"blockTime": 1784487060,
"fee": 2005000,
"feePayer": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
"transactionStatus": "OK",
"nativeTransfers": [
{
"fromUserAccount": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
"toUserAccount": "teBPkZtsnaKDpGHTy1KUZeh1PbVtbrKXhzruYpRiUUs",
"amount": 1500000000000
}
],
"tokenTransfers": [
{
"fromUserAccount": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
"toUserAccount": "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE",
"fromTokenAccount": "teBPkZtsnaKDpGHTy1KUZeh1PbVtbrKXhzruYpRiUUs",
"toTokenAccount": "2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
"rawTokenAmount": 1498500000000,
"decimals": 9,
"tokenStandard": "Fungible",
"mint": "So11111111111111111111111111111111111111112"
}
],
"summary": {
"type": "swap",
"description": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52 swapped 1500 SOL for 64672839.26195 pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn via Jupiter",
"parsedData": {
"type": "swap",
"protocol": "jupiter",
"kind": "swap",
"in_amount": "1500000000000",
"actual_out_amount": "64672839261950",
"input_mint": "So11111111111111111111111111111111111111112",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
"inner_swaps": [
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "470229300000",
"output_amount": "35579021038",
"input_mint": "So11111111111111111111111111111111111111112",
"output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
},
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "1028270700000",
"output_amount": "77798063361",
"input_mint": "So11111111111111111111111111111111111111112",
"output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
},
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "14625643887",
"output_amount": "8348494812168",
"input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
},
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "35566391375",
"output_amount": "20283004384731",
"input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
},
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "63185049137",
"output_amount": "36041340065051",
"input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
}
]
}
},
"instructions": [
{
"topIxIdx": 5,
"innerIxIdx": 2,
"stackHeight": 3,
"programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
"rawAccounts": [
"2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
"ATRsNGv2nDw7hSMfkUTBoVUDsFDwN7po7KbecyiGWNB4",
"7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE"
],
"rawData": "3JvpRSxKFyKV",
"summary": {
"type": "transfer",
"description": "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE transferred 470.2293 SOL from 7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE to 8FnX3xo2yYw3EUE6w3nQA4GfXGS9wpK6oj3veJpbFzLo",
"parsedData": null
},
"programName": "token",
"instructionName": "transfer",
"decoded": {
"args": {
"amount": "470229300000"
},
"accounts": [
{
"name": "source_account",
"pubkey": "2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
"isSigner": false,
"isWritable": true
},
{
"name": "destination_account",
"pubkey": "ATRsNGv2nDw7hSMfkUTBoVUDsFDwN7po7KbecyiGWNB4",
"isSigner": false,
"isWritable": true
},
{
"name": "owner_or_delegate",
"pubkey": "7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE",
"isSigner": true,
"isWritable": false
}
]
}
},
{
"topIxIdx": 5,
"innerIxIdx": 1,
"stackHeight": 2,
"programId": "BiSoNHVpsVZW2F7rx2eQ59yQwKxzU5NvBcmKshCSUypi",
"rawAccounts": [
"7iWnBRRhBCiNXXPhqiGzvvBkKrvFSWqqmxRyu9VyYBxE",
"8FnX3xo2yYw3EUE6w3nQA4GfXGS9wpK6oj3veJpbFzLo",
"ATRsNGv2nDw7hSMfkUTBoVUDsFDwN7po7KbecyiGWNB4",
"2Y7HATmn9aJBcxCskE5V2U2epmjvkZmB51zTJBbhj4cU",
"2oL6my4QDDCfpgJZX1bZV1NgbmuNptKdgcE8wJm6efgk",
"EpdaePzdqRkMtdZJquVPUWgyoJ5YEEpYALki6dv9VBrt",
"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
"Sysvar1nstructions1111111111111111111111111",
"J1to1yufRnoWn81KYg1XkTWzmKjnYSnmE2VY8DGUJ9Qv"
],
"rawData": "67t827t7UwAMHa6U18HnBBLj",
"summary": null,
"programName": "bison_fi",
"instructionName": null,
"decoded": null
}
]
}
}
]
```
例は2つの命令にトリムされています: ルート内のデコードされたトークン転送、およびプログラムがカタログで知られているがデコードできないAMM命令。これにより、`instructionName`が`null`になり、`rawData`および`rawAccounts`は利用可能なままです。各フィールドと完全な例のレスポンスについては[解析済みレスポンス](/docs/ja/parsed-events/parsed-response)を参照してください。
`POST /transaction-history`はアドレス用の同じ`TransactionResult`アイテムを返します。通常、新しいものから始まります:
```javascript theme={"system"}
const fetchTransactionHistory = async () => {
const url = "https:///transaction-history?api-key=YOUR_API_KEY";
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
address: "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
limit: 100,
sortOrder: "desc",
commitment: "confirmed",
}),
});
const page = await response.json();
console.log(page.data);
console.log(page.paginationToken);
};
fetchTransactionHistory();
```
```bash theme={"system"}
curl -X POST "https:///transaction-history?api-key=YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"address": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
"limit": 100,
"sortOrder": "desc",
"commitment": "confirmed"
}'
```
履歴レスポンスは結果をページオブジェクトでラップします。次のリクエストで継続するために`paginationToken`を返します。もし`paginationToken`が欠けている場合は、サービスが利用可能なページ範囲の終わりに達しています。
## ガイド
Pump.funでウォレットが展開したすべてのトークンをページネートします。
アプリが必要とする解析済みフィールドを正確に選択します。
## REST リファレンス
両方のエンドポイントは、Heliusチームが共有するエンドポイントで、`api-key`クエリパラメータで認証されたJSONボディを受け入れます。リクエストボディは未知のフィールドを拒否するので、タイプミスは静かに無視されるのではなく、明示的に失敗します。
### トランザクションを解析
`POST /transactions`は署名で完全なSolanaトランザクションを取得し、それらを[解析ストリーム](/docs/ja/parsed-streams)を支えるIDLベースの命令デコーダーでデコードし、要求された署名ごとに1つの`TransactionResult`を返します。同じメソッドはGraphQLで`transactions`として利用できます。
レスポンス順序は入力順序に一致し、重複する署名も含まれます。欠落したトランザクションおよびアイテムレベルのパーサー失敗はアイテムレベルの`parserStatus: "ERROR"`結果として返されます:
```json theme={"system"}
[
{
"signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
"parserStatus": "ERROR",
"parserError": {
"code": "transaction_not_found",
"message": "transaction was not found"
}
}
]
```
#### リクエストボディ
解析するトランザクション署名。最大バッチサイズは100です。
トランザクションを取得する際に使用されるコミットメントレベル。
* `confirmed`
* `finalized`
`true`の場合、各結果に`rawTransaction`として生のSolanaトランザクションペイロードを含めます。
#### 注意事項
* `processed`コミットメントはサポートされていません。
* `rawTransaction`は、`includeRawTransaction`が`true`でない限り省略されます。
* トランザクション実行エラーは依然として解析可能です。その場合、`parsed.transactionStatus`は`ERROR`になり、可能であればトランザクションエラーが`parsed.error`に公開されます。
* リクエストレベルの検証エラーはアイテムレベルの結果ではなくエラーレスポンスを返します。
### 解析済みトランザクション履歴
`POST /transaction-history`はアドレスの解析済みトランザクション履歴を返します。ページネーション、署名境界、スロット境界、ブロック時間境界、ソート順序、およびオプションの生のトランザクションをサポートします。同じメソッドはGraphQLで`transactionsByAddress`として利用可能です。
従来の[拡張トランザクション](/docs/ja/enhanced-transactions/transaction-history)アドレスエンドポイントとは異なり、リクエストパラメータはクエリストリングパラメータではなくJSONボディで送信されます。
#### リクエストボディ
トランザクション履歴を取得するアドレス。
返すトランザクションの数。`1`と`100`の間である必要があります。
この署名前のトランザクションを返します。
この署名後のトランザクションを返します。
前のレスポンスで返されたカーソル。
返されるトランザクションのソート順序。
* `asc`
* `desc`
履歴取得に使用されるコミットメントレベル。
* `confirmed`
* `finalized`
`true`の場合、各結果に`rawTransaction`として生のSolanaトランザクションペイロードを含めます。
スロット比較境界。各境界はオプションです: `gt`, `gte`, `lt`, `lte`.
Unix秒でのブロック時間比較境界。各境界はオプションです: `gt`, `gte`, `lt`, `lte`.
#### ページネーション
レスポンスはこの形状を持ちます。 各`data`アイテムは、解析トランザクションで返されるのと同じ`TransactionResult`フォーマットを使用します:
```json [expandable] theme={"system"}
{
"data": [
{
"signature": "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
"parserStatus": "OK",
"parsed": {
"slot": 433950192,
"blockTime": 1784487060,
"fee": 2005000,
"feePayer": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52",
"transactionStatus": "OK",
"nativeTransfers": [],
"tokenTransfers": [],
"summary": {
"type": "swap",
"description": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52 swapped 1500 SOL for 64672839.26195 pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn via Jupiter",
"parsedData": {
"type": "swap",
"protocol": "jupiter",
"kind": "swap",
"in_amount": "1500000000000",
"actual_out_amount": "64672839261950",
"input_mint": "So11111111111111111111111111111111111111112",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
"inner_swaps": [
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "470229300000",
"output_amount": "35579021038",
"input_mint": "So11111111111111111111111111111111111111112",
"output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
},
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "1028270700000",
"output_amount": "77798063361",
"input_mint": "So11111111111111111111111111111111111111112",
"output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
},
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "14625643887",
"output_amount": "8348494812168",
"input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
},
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "35566391375",
"output_amount": "20283004384731",
"input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
},
{
"amm_program_id": "",
"amm_program_name": null,
"input_amount": "63185049137",
"output_amount": "36041340065051",
"input_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"output_mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"
}
]
}
},
"instructions": []
}
}
],
"paginationToken": "433950192:0"
}
```
次のリクエストで継続するために`paginationToken`を返します。もし`paginationToken`が欠けている場合は、サービスが利用可能なページ範囲の終わりに達しています。