Metaplex

エージェント

POSTエージェントへの資金供給

Last updated August 1, 2026

送信者のウォレットからエージェントの署名者 PDA ウォレットへ、オンチェーンメモ付きで SOL を送金するトランザクションを構築します。誰でも任意のエージェントに資金を供給できます。

Summary

  • エージェントのウォレット PDA（エージェントアドレスからサーバー側で解決）に SOL を送金します
  • 帰属を示すため、送信者が署名する必須のメモインストラクションを付加します
  • 送信者が署名・送信するための未署名トランザクションを返します

Quick Reference

項目値
メソッドPOST
パス/agents/{address}/fund
認証不要
レスポンスシリアライズ済みトランザクション

エンドポイント

POST /agents/{address}/fund

パスパラメータ

パラメータ型必須説明
addressstringはいエージェントの Core アセットミントアドレス（base58）。

リクエストボディ

フィールド型必須説明
senderstringはいSOL を送るウォレット（base58）。トランザクションに署名します。
amountnumberはいSOL 単位の金額。正の値である必要があります。
memostringはいオンチェーンに記録されるメモ（1〜256文字）。
networkstringいいえsolana-mainnet（デフォルト）または solana-devnet。

リクエスト例

curl -X POST "https://api.metaplex.com/v1/agents/7nE9GvcwsqzYcPUYfm5gxzCKfmPqi68FM7gPaSfG6EQN/fund" \

  -H "Content-Type: application/json" \

  -d '{

    "sender": "4Nd1mYvJ9jVexjIXG5oJhanoGWyF7Cz6XkY8dEc4RsyG",

    "amount": 0.5,

    "memo": "Operating budget for July"

  }'

レスポンス

{

  "success": true,

  "tx": "<base64-encoded transaction>",

  "blockhash": {

    "blockhash": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",

    "lastValidBlockHeight": 123456789

  }

}

送信者はトランザクションをデシリアライズし、署名して送信します — 署名と送信をご参照ください。

エラー

ステータスボディ意味
400{ "success": false, "error": "Invalid input data" }ボディがバリデーションに失敗（不正な公開鍵、正でない金額、メモの欠落）。
404{ "success": false, "error": "Agent not found" }指定されたネットワークのこのアドレスに登録されたエージェントが存在しない。
500{ "success": false, "error": "Failed to prepare fund transaction" }サーバーエラー。

Notes

  • 送金先は Core アセットアドレスではなく、エージェントのウォレット PDA です — API が自動的に解決します。
  • 資金を引き出すには、エージェントのオーナーが エージェントからの出金 を使用します。
  • エージェントウォレットの背後にある概念については、エージェントファイナンスをご参照ください。
Next
エージェントからの出金