goldprice.devPlusまたはProでは、アカウントから金価格アラートを設定できます。FreeまたはBasicでは、APIの定期確認を設定し、自分の通知ツールに接続します。2026年10月29日 23:29 UTC時点の価格は、トロイオンス当たり$4,015.10です。無料の価格は十五分遅れです。
- PlusとProでは、それぞれ標準の価格アラートを五件利用できます。
- 標準アラートはリアルタイム価格を確認し、指定したURLに署名付きPOSTリクエストを送信します。
- FreeとBasicでは、定期確認を設定し、前回の状態を保存します。
標準アラートを作成
PlusとProでは、それぞれ価格アラートを五件利用できます。FreeとBasicには含まれません。料金を比較し、ログイン後にアカウントのアラートを開いて作成します。各アラートは、金、銀、銅のいずれか一つを監視します。
条件を一つ選びます。指定価格を上回る、下回る、どちらかに超える動き、一時間または二十四時間の変動率、日次終値から選べます。リアルタイム価格を確認し、価格水準や変動率の通知は各アラートで一時間に最大一回、日次終値の通知はUTCの一日につき一回送信します。
FreeやBasicで定期確認を設定
FreeとBasicでは、以下のリクエストを十五分ごとに実行します。/v1/spot/XAU-USD-SPOTからトロイオンス当たりの金価格を取得します。通知の基準価格も同じ通貨と単位で指定します。キーなしのリクエストは登録も不要なので、アカウントなしで始められます。
この間隔では、一時間に四回、一日に九十六回、一か月に約二千九百回のリクエストになります。キーなしの上限であるIPごとに一分間十回、一時間百回と、無料キーの月間五千回の枠に収まります。
curl "https://api.goldprice.dev/v1/spot/XAU-USD-SPOT"配信と署名を確認
標準アラートは、JSON本文を含む署名付きPOSTリクエストを指定したURLに送信します。公開ホスト名とポート443のhttpsを使用してください。プライベートアドレスやローカルアドレスは使えません。本文にはevent、alert_id、kind、symbol、direction、price、observed_atが含まれます。条件別の項目は、level、percentとwindowとreference_price、またはdateとcloseです。
Webhook-Signatureヘッダーの形式はt=<unix time>,v1=<HMAC SHA-256 of "<t>.<body>" with your signing secret>です。署名用シークレットは作成時に一度だけ表示されるため、保存してください。受信した本文で署名を検証し、五分を超えた古い署名は拒否します。
アラート画面からテスト送信し、受信先URLを確認します。goldprice.devはメールやSMSを送りません。POSTの送信先には、チャットツールの受信用Webhookや小規模なサーバーなど、自分で管理するURLを指定します。
定期確認の状態を保存
定期確認では、価格を比較する前にis_staleとcomputed_atを確認します。無料の価格は十五分遅れです。最初の有効な取得値で、価格が基準を上回っているか下回っているかを判断し、その状態を保存します。
後の有効な取得値が基準価格を超えたときに通知します。上昇時は、基準未満から基準以上に変わったときです。下落時は比較を逆にします。同じ側にある値を繰り返し取得しても通知は繰り返しません。確認の合間に基準を超えて戻った動きは見逃すことがあります。
設定チュートリアルを利用
価格アラートのチュートリアルでは、価格を確認し、前回の状態を保存して、チャットサービスの受信用Webhookに投稿するスクリプトを紹介しています。定期リクエストから通知までの仕組みを作れます。
スクリプトを書かずに設定する場合は、定期ワークフローのチュートリアルやを参照してください。どの方法でも、価格の鮮度、単位の一致、状態の保存を確認します。通知は選んだツールを通じて送信されます。