Documentation
¶
Index ¶
- Variables
- func APIKey() string
- func OpenQuote(handlers ...func(Quote)) (closeFunc func(), err error)
- func SetAPIKey(k string)
- func SetBaseURL(u string)
- func SetHTTPClient(c *http.Client)
- type APIError
- type ErrorResponse
- type Handler
- type Quote
- type ReqGetInfoApisoftlimit
- type ReqGetInfoBoardSymbol
- type ReqGetInfoExchangeSymbol
- type ReqGetInfoMarginMarginpremiumSymbol
- type ReqGetInfoOrders
- type ReqGetInfoPositions
- type ReqGetInfoPrimaryexchangeSymbol
- type ReqGetInfoRanking
- type ReqGetInfoRegulationsSymbol
- type ReqGetInfoSymbolSymbol
- type ReqGetInfoSymbolnameFuture
- type ReqGetInfoSymbolnameMinioptionweekly
- type ReqGetInfoSymbolnameOption
- type ReqGetWalletWalletCash
- type ReqGetWalletWalletCashSymbol
- type ReqGetWalletWalletFuture
- type ReqGetWalletWalletFutureSymbol
- type ReqGetWalletWalletMargin
- type ReqGetWalletWalletMarginSymbol
- type ReqGetWalletWalletOption
- type ReqGetWalletWalletOptionSymbol
- type ReqPostAuthToken
- type ReqPostOrderSendorder
- type ReqPostOrderSendorderFuture
- type ReqPostOrderSendorderOption
- type ReqPutOrderCancelorder
- type ReqPutRegisterRegister
- type ReqPutRegisterUnregister
- type ReqPutRegisterUnregisterAll
- type ResGetInfoApisoftlimit
- type ResGetInfoBoardSymbol
- type ResGetInfoExchangeSymbol
- type ResGetInfoMarginMarginpremiumSymbol
- type ResGetInfoOrders
- type ResGetInfoPositions
- type ResGetInfoPrimaryexchangeSymbol
- type ResGetInfoRanking
- type ResGetInfoRegulationsSymbol
- type ResGetInfoSymbolSymbol
- type ResGetInfoSymbolnameFuture
- type ResGetInfoSymbolnameMinioptionweekly
- type ResGetInfoSymbolnameOption
- type ResGetWalletWalletCash
- type ResGetWalletWalletCashSymbol
- type ResGetWalletWalletFuture
- type ResGetWalletWalletFutureSymbol
- type ResGetWalletWalletMargin
- type ResGetWalletWalletMarginSymbol
- type ResGetWalletWalletOption
- type ResGetWalletWalletOptionSymbol
- type ResPostAuthToken
- type ResPostOrderSendorder
- type ResPostOrderSendorderFuture
- type ResPostOrderSendorderOption
- type ResPutOrderCancelorder
- type ResPutRegisterRegister
- type ResPutRegisterUnregister
- type ResPutRegisterUnregisterAll
Constants ¶
This section is empty.
Variables ¶
var BaseURL = "http://localhost:18080/kabusapi"
BaseURL は API のベースURL。 変更したい場合は SetBaseURL("http://localhost:18081/kabusapi") のように設定してください。
var HTTPClient = &http.Client{Timeout: 30 * time.Second}
HTTPClient は REST 呼び出しに使用されるクライアントです。必要に応じて差し替え可能です。
Functions ¶
func APIKey ¶
func APIKey() string
APIKey は現在設定されているトークンを返します。
機能:
- SetAPIKey で保持した X-API-KEY 用トークンを参照する。
引数:
- なし。
返り値:
- string: 現在保持している API トークン。未設定の場合は空文字。
func OpenQuote ¶
OpenQuote は WebSocket に接続して板情報を受信し、ハンドラーへ配信します。
機能:
- kabuステーションの WebSocket エンドポイントへ接続し、受信した Quote を逐次ハンドラーへ渡す。
- 返された closeFunc を呼び出すことで受信ループと接続を安全に終了できる。
引数:
- handlers (...func(Quote)): 受信した Quote を処理するコールバック。nil は無視される。
返り値:
- closeFunc (func()): 接続と受信を停止させるための関数。
- err (error): 初回接続に失敗した場合のエラー。
func SetAPIKey ¶
func SetAPIKey(k string)
SetAPIKey は X-API-KEY ヘッダー用のトークンを設定します。
機能:
- API 呼び出し時に利用するトークンを上書きして保持する。
引数:
- k (string): 新しく設定する API トークン。
返り値:
- なし。
func SetBaseURL ¶
func SetBaseURL(u string)
SetBaseURL は BaseURL を差し替えます。
機能:
- API の送信先となるベース URL を上書きし、末尾のスラッシュを除去する。
引数:
- u (string): 新しいベース URL。空文字は無視される。
返り値:
- なし。
func SetHTTPClient ¶
SetHTTPClient は使用する http.Client を差し替えます。
機能:
- REST 呼び出しに使用する HTTP クライアントを任意の設定に置き換える。
引数:
- c (*http.Client): 使用したいクライアント。nil の場合は既定を維持。
返り値:
- なし。
Types ¶
type APIError ¶
type APIError struct {
StatusCode int // HTTPステータスコード
Code int // API固有のエラーコード
Message string // APIメッセージ
Body string // 生のレスポンスボディ
}
APIError は非2xxのHTTPレスポンスを表すエラーです。
type ErrorResponse ¶
type ErrorResponse struct {
Code int `json:"Code,omitempty"`
Message string `json:"Message,omitempty"`
}
ErrorResponse はエラー時のレスポンスボディです。
type Quote ¶
type Quote struct {
AskPrice float64 `json:"AskPrice"`
AskQty float64 `json:"AskQty"`
AskSign string `json:"AskSign"`
BidPrice float64 `json:"BidPrice"`
BidQty float64 `json:"BidQty"`
BidSign string `json:"BidSign"`
Buy1 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
Sign string `json:"Sign"`
} `json:"Buy1"`
Buy10 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Buy10"`
Buy2 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Buy2"`
Buy3 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Buy3"`
Buy4 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Buy4"`
Buy5 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Buy5"`
Buy6 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Buy6"`
Buy7 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Buy7"`
Buy8 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Buy8"`
Buy9 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Buy9"`
CalcPrice float64 `json:"CalcPrice"`
ChangePreviousClose float64 `json:"ChangePreviousClose"`
ChangePreviousClosePer float64 `json:"ChangePreviousClosePer"`
ClearingPrice float64 `json:"ClearingPrice"`
CurrentPrice float64 `json:"CurrentPrice"`
CurrentPriceChangeStatus string `json:"CurrentPriceChangeStatus"`
CurrentPriceStatus float64 `json:"CurrentPriceStatus"`
CurrentPriceTime time.Time `json:"CurrentPriceTime"`
Exchange float64 `json:"Exchange"`
ExchangeName string `json:"ExchangeName"`
HighPrice float64 `json:"HighPrice"`
HighPriceTime time.Time `json:"HighPriceTime"`
LowPrice float64 `json:"LowPrice"`
LowPriceTime time.Time `json:"LowPriceTime"`
OpeningPrice float64 `json:"OpeningPrice"`
OpeningPriceTime time.Time `json:"OpeningPriceTime"`
PreviousClose float64 `json:"PreviousClose"`
PreviousCloseTime time.Time `json:"PreviousCloseTime"`
SecurityType float64 `json:"SecurityType"`
Sell1 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
Sign string `json:"Sign"`
} `json:"Sell1"`
Sell10 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Sell10"`
Sell2 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Sell2"`
Sell3 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Sell3"`
Sell4 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Sell4"`
Sell5 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Sell5"`
Sell6 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Sell6"`
Sell7 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Sell7"`
Sell8 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Sell8"`
Sell9 struct {
Price float64 `json:"Price"`
Qty float64 `json:"Qty"`
} `json:"Sell9"`
Symbol string `json:"Symbol"`
SymbolName string `json:"SymbolName"`
TradingValue float64 `json:"TradingValue"`
TradingVolume float64 `json:"TradingVolume"`
TradingVolumeTime time.Time `json:"TradingVolumeTime"`
VWAP float64 `json:"VWAP"`
}
Websocket受信データ
type ReqGetInfoApisoftlimit ¶
type ReqGetInfoApisoftlimit struct {
}
ReqGetInfoApisoftlimit は **GET /apisoftlimit** のリクエスト。
ソフトリミット
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetInfoBoardSymbol ¶
type ReqGetInfoBoardSymbol struct {
// 銘柄コード ※次の形式で入力してください。 [銘柄コード]@[市場コード] ※市場コードは下記の定義値から選択してください。 ※SOR市場は取扱っておりませんのでご注意ください。市場コード 定義値 説明 1 東証 3 名証 5 福証 6 札証 2 日通し 23 日中 24 夜間
Symbol string `json:"-" path:"symbol"`
}
ReqGetInfoBoardSymbol は **GET /board/{symbol}** のリクエスト。
時価情報・板情報
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetInfoExchangeSymbol ¶
type ReqGetInfoExchangeSymbol struct {
// 通貨 定義値 内容 usdjpy USD/JPY eurjpy EUR/JPY gbpjpy GBP/JPY audjpy AUD/JPY chfjpy CHF/JPY cadjpy CAD/JPY nzdjpy NZD/JPY zarjpy ZAR/JPY eurusd EUR/USD gbpusd GBP/USD audusd AUD/USD
Symbol string `json:"-" path:"symbol"`
}
ReqGetInfoExchangeSymbol は **GET /exchange/{symbol}** のリクエスト。
為替情報
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetInfoMarginMarginpremiumSymbol ¶
type ReqGetInfoMarginMarginpremiumSymbol struct {
Symbol string `json:"-" path:"symbol"`
}
ReqGetInfoMarginMarginpremiumSymbol は **GET /margin/marginpremium/{symbol}** のリクエスト。
プレミアム料取得
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetInfoOrders ¶
type ReqGetInfoOrders struct {
// 取得する商品 定義値 説明 0 すべて 1 現物 2 信用 3 先物 4 OP
Product string `json:"-" query:"product"`
// 注文番号 ※指定された注文番号と一致する注文のみレスポンスします。 ※指定された注文番号との比較では大文字小文字を区別しません。 ※複数の注文番号を指定することはできません。
ID string `json:"-" query:"id"`
// 更新日時 ※形式:yyyyMMddHHmmss (例:20201201123456) ※指定された更新日時以降(指定日時含む)に更新された注文のみレスポンスします。 ※複数の更新日時を指定することはできません。
Updtime string `json:"-" query:"updtime"`
// 注文詳細抑止 定義値 説明 true 注文詳細を出力する(デフォルト) false 注文詳細の出力しない
Details string `json:"-" query:"details"`
// 銘柄コード ※指定された銘柄コードと一致する注文のみレスポンスします。 ※複数の銘柄コードを指定することができません。
Symbol string `json:"-" query:"symbol"`
// 状態 ※指定された状態と一致する注文のみレスポンスします。 ※フィルタには数字の入力のみ受け付けます。 ※複数の状態を指定することはできません。 定義値 説明 1 待機(発注待機) 2 処理中(発注送信中) 3 処理済(発注済・訂正済) 4 訂正取消送信中 5 終了(発注エラー・取消済・全約定・失効・期限切れ)
State string `json:"-" query:"state"`
// 売買区分 ※指定された売買区分と一致する注文のみレスポンスします。 ※フィルタには数字の入力のみ受け付けます。 ※複数の売買区分を指定することができません。 定義値 説明 1 売 2 買
Side string `json:"-" query:"side"`
// 取引区分 ※指定された取引区分と一致する注文のみレスポンスします。 ※フィルタには数字の入力のみ受け付けます。 ※複数の取引区分を指定することができません。 定義値 説明 2 新規 3 返済
Cashmargin string `json:"-" query:"cashmargin"`
}
ReqGetInfoOrders は **GET /orders** のリクエスト。
注文約定照会
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetInfoPositions ¶
type ReqGetInfoPositions struct {
// 取得する商品 定義値 説明 0 すべて 1 現物 2 信用 3 先物 4 OP
Product string `json:"-" query:"product"`
// 銘柄コード ※指定された銘柄コードと一致するポジションのみレスポンスします。 ※複数の銘柄コードを指定することはできません。
Symbol string `json:"-" query:"symbol"`
// 売買区分フィルタ 指定された売買区分と一致する注文を返す 定義値 説明 1 売 2 買
Side string `json:"-" query:"side"`
// 追加情報出力フラグ(未指定時:true) ※追加情報は、「現在値」、「評価金額」、「評価損益額」、「評価損益率」を意味します。 定義値 説明 true 追加情報を出力する false 追加情報を出力しない
Addinfo string `json:"-" query:"addinfo"`
}
ReqGetInfoPositions は **GET /positions** のリクエスト。
残高照会
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetInfoPrimaryexchangeSymbol ¶
type ReqGetInfoPrimaryexchangeSymbol struct {
// 銘柄コード
Symbol string `json:"-" path:"symbol"`
}
ReqGetInfoPrimaryexchangeSymbol は **GET /primaryexchange/{symbol}** のリクエスト。
優先市場
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetInfoRanking ¶
type ReqGetInfoRanking struct {
// 種別 ※信用情報ランキングに「福証」「札証」を指定した場合は、空レスポンスになります 定義値 説明 1 値上がり率(デフォルト) 2 値下がり率 3 売買高上位 4 売買代金 5 TICK回数 6 売買高急増 7 売買代金急増 8 信用売残増 9 信用売残減 10 信用買残増 11 信用買残減 12 信用高倍率 13 信用低倍率 14 業種別値上がり率 15 業種別値下がり率
Type string `json:"-" query:"Type" required:"true"`
// 市場 ※業種別値上がり率・値下がり率に市場を指定しても無視されます 定義値 説明 ALL 全市場(デフォルト) T 東証全体 TP 東証プライム TS 東証スタンダード TG グロース250 M 名証 FK 福証 S 札証
ExchangeDivision string `json:"-" query:"ExchangeDivision" required:"true"`
}
ReqGetInfoRanking は **GET /ranking** のリクエスト。
詳細ランキング
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetInfoRegulationsSymbol ¶
type ReqGetInfoRegulationsSymbol struct {
// 銘柄コード ※次の形式で入力してください。 [銘柄コード]@[市場コード] ※市場コードは下記の定義値から選択してください。 市場コード 定義値 説明 1 東証 3 名証 5 福証 6 札証
Symbol string `json:"-" path:"symbol"`
}
ReqGetInfoRegulationsSymbol は **GET /regulations/{symbol}** のリクエスト。
規制情報
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetInfoSymbolSymbol ¶
type ReqGetInfoSymbolSymbol struct {
// 銘柄コード ※次の形式で入力してください。 [銘柄コード]@[市場コード] ※市場コードは下記の定義値から選択してください。 ※SOR市場は取扱っておりませんのでご注意ください。市場コード 定義値 説明 1 東証 3 名証 5 福証 6 札証 2 日通し 23 日中 24 夜間
Symbol string `json:"-" path:"symbol"`
// 追加情報出力フラグ(未指定時:true) ※追加情報は、「時価総額」、「発行済み株式数」、「決算期日」、「清算値」を意味します。 定義値 説明 true 追加情報を出力する false 追加情報を出力しない
Addinfo string `json:"-" query:"addinfo"`
}
ReqGetInfoSymbolSymbol は **GET /symbol/{symbol}** のリクエスト。
銘柄情報
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetInfoSymbolnameFuture ¶
type ReqGetInfoSymbolnameFuture struct {
// 先物コード ※大文字小文字は区別しません。 定義値 説明 NK225 日経平均先物 NK225mini 日経225mini先物 TOPIX TOPIX先物 TOPIXmini ミニTOPIX先物 GROWTH グロース250先物 JPX400 JPX日経400先物 DOW NYダウ先物 VI 日経平均VI先物 Core30 TOPIX Core30先物 REIT 東証REIT指数先物 NK225micro 日経225マイクロ先物
FutureCode string `json:"-" query:"FutureCode"`
// 限月 ※限月はyyyyMM形式で指定します。0を指定した場合、直近限月となります。 ※取引最終日に「0」(直近限月)を指定した場合、日中・夜間の時間帯に関わらず、 取引最終日を迎える限月の銘柄コードを返します。取引最終日を迎える銘柄の取引は日中取引をもって終了となりますので、ご注意ください。
DerivMonth string `json:"-" query:"DerivMonth" required:"true"`
}
ReqGetInfoSymbolnameFuture は **GET /symbolname/future** のリクエスト。
先物銘柄コード取得
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetInfoSymbolnameMinioptionweekly ¶
type ReqGetInfoSymbolnameMinioptionweekly struct {
// 限月 ※限月はyyyyMM形式で指定します。0を指定した場合、直近限月となります。 ※取引最終日に「0」(直近限月)を指定した場合、日中・夜間の時間帯に関わらず、取引最終日を迎える限月の銘柄コードを返します。取引最終日を迎える銘柄の取引は日中取引をもって終了となりますので、ご注意ください。
DerivMonth string `json:"-" query:"DerivMonth" required:"true"`
// 限週 ※限週は0,1,3,4,5のいずれかを指定します。0を指定した場合、指定した限月の直近限週となります。 ※取引最終日に「0」(直近限週)を指定した場合、日中・夜間の時間帯に関わらず、取引最終日を迎える限週の銘柄コードを返します。取引最終日を迎える銘柄の取引は日中取引をもって終了となりますので、ご注意ください。
DerivWeekly int `json:"-" query:"DerivWeekly" required:"true"`
// コール or プット ※大文字小文字は区別しません。 定義値 説明 P PUT C CALL
PutOrCall string `json:"-" query:"PutOrCall" required:"true"`
// 権利行使価格 ※0を指定した場合、APIを実行した時点でのATMとなります。
StrikePrice int `json:"-" query:"StrikePrice" required:"true"`
}
ReqGetInfoSymbolnameMinioptionweekly は **GET /symbolname/minioptionweekly** のリクエスト。
ミニオプション(限週)銘柄コード取得
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetInfoSymbolnameOption ¶
type ReqGetInfoSymbolnameOption struct {
// オプションコード ※指定なしの場合は、日経225オプションを対象とする。 定義値 説明 NK225op 日経225オプション NK225miniop 日経225ミニオプション
OptionCode string `json:"-" query:"OptionCode"`
// 限月 ※限月はyyyyMM形式で指定します。0を指定した場合、直近限月となります。 ※取引最終日に「0」(直近限月)を指定した場合、日中・夜間の時間帯に関わらず、取引最終日を迎える限月の銘柄コードを返します。取引最終日を迎える銘柄の取引は日中取引をもって終了となりますので、ご注意ください。
DerivMonth string `json:"-" query:"DerivMonth" required:"true"`
// コール or プット ※大文字小文字は区別しません。 定義値 説明 P PUT C CALL
PutOrCall string `json:"-" query:"PutOrCall" required:"true"`
// 権利行使価格 ※0を指定した場合、APIを実行した時点でのATMとなります。
StrikePrice int `json:"-" query:"StrikePrice" required:"true"`
}
ReqGetInfoSymbolnameOption は **GET /symbolname/option** のリクエスト。
オプション銘柄コード取得
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetWalletWalletCash ¶
type ReqGetWalletWalletCash struct {
}
ReqGetWalletWalletCash は **GET /wallet/cash** のリクエスト。
### 概要 取引余力(現物)
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetWalletWalletCashSymbol ¶
type ReqGetWalletWalletCashSymbol struct {
// 銘柄コード <br> ※次の形式で入力してください。<br> [銘柄コード]@[市場コード]<br> ※市場コードは下記の定義値から選択してください。 <b>市場コード</b> <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>東証</td> </tr> <tr> <td>3</td> <td>名証</td> </tr> <tr> <td>5</td> <td>福証</td> </tr> <tr> <td>6</td> <td>札証</td> </tr> <tr> <td>9</td> <td>SOR</td> </tr> <tr> <td>27</td> <td>東証+</td> </tr> </tbody> </table>
Symbol string `json:"-" path:"symbol"`
}
ReqGetWalletWalletCashSymbol は **GET /wallet/cash/{symbol}** のリクエスト。
### 概要 取引余力(現物)(銘柄指定)
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetWalletWalletFuture ¶
type ReqGetWalletWalletFuture struct {
}
ReqGetWalletWalletFuture は **GET /wallet/future** のリクエスト。
### 概要 取引余力(先物)
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetWalletWalletFutureSymbol ¶
type ReqGetWalletWalletFutureSymbol struct {
// 銘柄コード <br> ※次の形式で入力してください。<br> [銘柄コード]@[市場コード]<br> ※市場コードは下記の定義値から選択してください。 ※SOR市場は取扱っておりませんのでご注意ください。<b>市場コード</b><br> <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>2</td> <td>日通し</td> </tr> <tr> <td>23</td> <td>日中</td> </tr> <tr> <td>24</td> <td>夜間</td> </tr> </tbody> </table>
Symbol string `json:"-" path:"symbol"`
}
ReqGetWalletWalletFutureSymbol は **GET /wallet/future/{symbol}** のリクエスト。
### 概要 取引余力(先物)(銘柄指定)
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetWalletWalletMargin ¶
type ReqGetWalletWalletMargin struct {
}
ReqGetWalletWalletMargin は **GET /wallet/margin** のリクエスト。
### 概要 取引余力(信用)
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetWalletWalletMarginSymbol ¶
type ReqGetWalletWalletMarginSymbol struct {
// 銘柄コード <br> ※次の形式で入力してください。<br> [銘柄コード]@[市場コード]<br> ※市場コードは下記の定義値から選択してください。 <b>市場コード</b> <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>東証</td> </tr> <tr> <td>3</td> <td>名証</td> </tr> <tr> <td>9</td> <td>SOR</td> </tr> <tr> <td>27</td> <td>東証+</td> </tr> </tbody> </table>
Symbol string `json:"-" path:"symbol"`
}
ReqGetWalletWalletMarginSymbol は **GET /wallet/margin/{symbol}** のリクエスト。
### 概要 取引余力(信用)(銘柄指定)
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetWalletWalletOption ¶
type ReqGetWalletWalletOption struct {
}
ReqGetWalletWalletOption は **GET /wallet/option** のリクエスト。
### 概要 取引余力(オプション)
- 認証: 必須(X-API-KEY ヘッダー)
type ReqGetWalletWalletOptionSymbol ¶
type ReqGetWalletWalletOptionSymbol struct {
// 銘柄コード <br> ※次の形式で入力してください。<br> [銘柄コード]@[市場コード]<br> ※市場コードは下記の定義値から選択してください。 <b>市場コード</b> <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>2</td> <td>日通し</td> </tr> <tr> <td>23</td> <td>日中</td> </tr> <tr> <td>24</td> <td>夜間</td> </tr> </tbody> </table>
Symbol string `json:"-" path:"symbol"`
}
ReqGetWalletWalletOptionSymbol は **GET /wallet/option/{symbol}** のリクエスト。
### 概要 取引余力(オプション)(銘柄指定)
- 認証: 必須(X-API-KEY ヘッダー)
type ReqPostAuthToken ¶
type ReqPostAuthToken struct {
// APIパスワード
APIPassword string `json:"APIPassword" validate:"required"`
}
ReqPostAuthToken は **POST /token** のリクエスト。
### 概要 トークン発行
type ReqPostOrderSendorder ¶
type ReqPostOrderSendorder struct {
// 銘柄コード
Symbol string `json:"Symbol" validate:"required"`
// 市場コード <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>東証</td> </tr> <tr> <td>3</td> <td>名証</td> </tr> <tr> <td>5</td> <td>福証</td> </tr> <tr> <td>6</td> <td>札証</td> </tr> <tr> <td>9</td> <td>SOR</td> </tr> <tr> <td>27</td> <td>東証+</td> </tr> </tbody> </table>
Exchange int `json:"Exchange" validate:"required"`
// 商品種別 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>株式</td> </tr> </tbody> </table>
SecurityType int `json:"SecurityType" validate:"required"`
// 売買区分 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>売</td> </tr> <tr> <td>2</td> <td>買</td> </tr> </tbody> </table>
Side string `json:"Side" validate:"required"`
// 信用区分 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>現物</td> </tr> <tr> <td>2</td> <td>新規</td> </tr> <tr> <td>3</td> <td>返済</td> </tr> </tbody> </table>
CashMargin int `json:"CashMargin" validate:"required"`
// 信用取引区分<br>※現物取引の場合は指定不要。<br>※信用取引の場合、必須。 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>制度信用</td> </tr> <tr> <td>2</td> <td>一般信用(長期)</td> </tr> <tr> <td>3</td> <td>一般信用(デイトレ)</td> </tr> </tbody> </table>
MarginTradeType int `json:"MarginTradeType"`
// 1株あたりのプレミアム料(円)<br> ※プレミアム料の刻値は、プレミアム料取得APIのレスポンスにある"TickMarginPremium"にてご確認ください。<br> ※入札受付中(19:30~20:30)プレミアム料入札可能銘柄の場合、「MarginPremiumUnit」は必須となります。<br> ※入札受付中(19:30~20:30)のプレミアム料入札可能銘柄以外の場合は、「MarginPremiumUnit」の記載は無視されます。<br> ※入札受付中以外の時間帯では、「MarginPremiumUnit」の記載は無視されます。
MarginPremiumUnit float64 `json:"MarginPremiumUnit"`
// 受渡区分<br>※現物買は指定必須。<br>※現物売は「0(指定なし)」を設定<br>※信用新規は「0(指定なし)」を設定<br>※信用返済は指定必須 <br>※auマネーコネクトが有効の場合にのみ、「3」を設定可能 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>0</td> <td>指定なし</td> </tr> <tr> <td>2</td> <td>お預り金</td> </tr> <tr> <td>3</td> <td>auマネーコネクト</td> </tr> </tbody> </table>
DelivType int `json:"DelivType" validate:"required"`
// 資産区分(預り区分)<br>※現物買は、指定必須。<br>※現物売は、「' '」 半角スペース2つを指定必須。<br>※信用新規と信用返済は、「11」を指定するか、または指定なしでも可。指定しない場合は「11」が自動的にセットされます。 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>(半角スペース2つ)</td> <td>現物売の場合</td> </tr> <tr> <td>02</td> <td>保護</td> </tr> <tr> <td>AA</td> <td>信用代用</td> </tr> <tr> <td>11</td> <td>信用取引</td> </tr> </tbody> </table>
FundType string `json:"FundType"`
// 口座種別 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>2</td> <td>一般</td> </tr> <tr> <td>4</td> <td>特定</td> </tr> <tr> <td>12</td> <td>法人</td> </tr> </tbody> </table>
AccountType int `json:"AccountType" validate:"required"`
// 注文数量<br>※信用一括返済の場合、返済したい合計数量を入力してください。
Qty int `json:"Qty" validate:"required"`
// 決済順序<br>※信用返済の場合、必須。<br>※ClosePositionOrderとClosePositionsはどちらか一方のみ指定可能。<br>※ClosePositionOrderとClosePositionsを両方指定した場合、エラー。 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>0</td> <td>日付(古い順)、損益(高い順)</td> </tr> <tr> <td>1</td> <td>日付(古い順)、損益(低い順)</td> </tr> <tr> <td>2</td> <td>日付(新しい順)、損益(高い順)</td> </tr> <tr> <td>3</td> <td>日付(新しい順)、損益(低い順)</td> </tr> <tr> <td>4</td> <td>損益(高い順)、日付(古い順)</td> </tr> <tr> <td>5</td> <td>損益(高い順)、日付(新しい順)</td> </tr> <tr> <td>6</td> <td>損益(低い順)、日付(古い順)</td> </tr> <tr> <td>7</td> <td>損益(低い順)、日付(新しい順)</td> </tr> </tbody> </table>
ClosePositionOrder int `json:"ClosePositionOrder"`
// 返済建玉指定<br>※信用返済の場合、必須。<br>※ClosePositionOrderとClosePositionsはどちらか一方のみ指定可能。<br>※ClosePositionOrderとClosePositionsを両方指定した場合、エラー。<br>※信用一括返済の場合、各建玉IDと返済したい数量を入力してください。<br>※建玉IDは「E」から始まる番号です。
ClosePositions []struct {
HoldID string `json:"HoldID,omitempty"` // 返済建玉ID
Qty int `json:"Qty,omitempty"` // 返済建玉数量
} `json:"ClosePositions"`
// 執行条件 ※SOR以外は以下、全て指定可能です。 <table> <thead> <tr> <th>定義値</th> <th>説明</th> <th>”Price"の指定</th> <th>SORで発注可</th> </tr> </thead> <tbody> <tr> <td>10</td> <td>成行</td> <td>0</td> <td>〇</td> </tr> <tr> <td>13</td> <td>寄成(前場)</td> <td>0</td> <td> </td> </tr> <tr> <td>14</td> <td>寄成(後場)</td> <td>0</td> <td> </td> </tr> <tr> <td>15</td> <td>引成(前場)</td> <td>0</td> <td> </td> </tr> <tr> <td>16</td> <td>引成(後場)</td> <td>0</td> <td> </td> </tr> <tr> <td>17</td> <td>IOC成行</td> <td>0</td> <td> </td> </tr> <tr> <td>20</td> <td>指値</td> <td>発注したい金額</td> <td>〇</td> </tr> <tr> <td>21</td> <td>寄指(前場)</td> <td>発注したい金額</td> <td> </td> </tr> <tr> <td>22</td> <td>寄指(後場)</td> <td>発注したい金額</td> <td> </td> </tr> <tr> <td>23</td> <td>引指(前場)</td> <td>発注したい金額</td> <td> </td> </tr> <tr> <td>24</td> <td>引指(後場)</td> <td>発注したい金額</td> <td> </td> </tr> <tr> <td>25</td> <td>不成(前場)</td> <td>発注したい金額</td> <td> </td> </tr> <tr> <td>26</td> <td>不成(後場)</td> <td>発注したい金額</td> <td> </td> </tr> <tr> <td>27</td> <td>IOC指値</td> <td>発注したい金額</td> <td> </td> </tr> <tr> <td>30</td> <td>逆指値</td> <td>指定なし<br>※AfterHitPriceで指定ください</td> <td>〇</td> </tr> </tbody> </table>
FrontOrderType int `json:"FrontOrderType" validate:"required"`
// 注文価格<br>※FrontOrderTypeで成行を指定した場合、0を指定する。<br>※詳細について、”FrontOrderType”をご確認ください。
Price float64 `json:"Price" validate:"required"`
// 注文有効期限<br> yyyyMMdd形式。<br> 「0」を指定すると、kabuステーション上の発注画面の「本日」に対応する日付として扱います。<br> 「本日」は直近の注文可能日となり、以下のように設定されます。<br> 引けまでの間 : 当日<br> 引け後 : 翌取引所営業日<br> 休前日 : 休日明けの取引所営業日<br> ※ 日替わりはkabuステーションが日付変更通知を受信したタイミングです。
ExpireDay int `json:"ExpireDay" validate:"required"`
// 逆指値条件<br> ※FrontOrderTypeで逆指値を指定した場合のみ必須。
ReverseLimitOrder struct {
TriggerSec int `json:"TriggerSec,omitempty"` // トリガ銘柄<br> ※未設定の場合はエラーになります。 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>発注銘柄</td> </tr> <tr> <td>2</td> <td>NK225指数</td> </tr> <tr> <td>3</td> <td>TOPIX指数</td> </tr> </tbody> </table>
TriggerPrice float64 `json:"TriggerPrice,omitempty"` // トリガ価格<br> ※未設定の場合はエラーになります。<br> ※数字以外が設定された場合はエラーになります。
UnderOver int `json:"UnderOver,omitempty"` // 以上/以下<br> ※未設定の場合はエラーになります。<br> ※1、2以外が指定された場合はエラーになります。 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>以下</td> </tr> <tr> <td>2</td> <td>以上</td> </tr> </tbody> </table>
AfterHitOrderType int `json:"AfterHitOrderType,omitempty"` // ヒット後執行条件<br> ※未設定の場合はエラーになります。<br> ※1、2、3以外が指定された場合はエラーになります。 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>成行</td> </tr> <tr> <td>2</td> <td>指値</td> </tr> <tr> <td>3</td> <td>不成</td> </tr> </tbody> </table>
AfterHitPrice float64 `json:"AfterHitPrice,omitempty"` // ヒット後注文価格<br> ※未設定の場合はエラーになります。<br> ※数字以外が設定された場合はエラーになります。<br><br> ヒット後執行条件に従い、下記のようにヒット後注文価格を設定してください。 <table> <thead> <tr> <th>ヒット後執行条件</th> <th>設定価格</th> </tr> </thead> <tbody> <tr> <td>成行</td> <td>0</td> </tr> <tr> <td>指値</td> <td>指値の単価</td> </tr> <tr> <td>不成</td> <td>不成の単価</td> </tr> </tbody> </table>
} `json:"ReverseLimitOrder"`
}
ReqPostOrderSendorder は **POST /sendorder** のリクエスト。
### 概要 注文発注(現物・信用)
- 認証: 必須(X-API-KEY ヘッダー)
type ReqPostOrderSendorderFuture ¶
type ReqPostOrderSendorderFuture struct {
// Symbol は先物銘柄コード。
// 取引最終日に DerivMonth=0(直近限月)を指定した場合は最終日の限月コードが返るため、日中引けで取引終了となる点に注意。
Symbol string `json:"Symbol" validate:"required"`
// Exchange は市場コード。2:日通し、23:日中、24:夜間、32:SOR日通し、33:SOR日中、34:SOR夜間。
// SOR は日経225先物(ラージ/ミニ)、TOPIX(ラージ/ミニ)、東証マザーズ指数、JPX日経400、NYダウなど一部銘柄のみ有効。
Exchange int `json:"Exchange" validate:"required"`
// TradeType は取引区分。1:新規、2:返済。
TradeType int `json:"TradeType" validate:"required"`
// TimeInForce は有効期間条件。1:FAS、2:FAK、3:FOK。
// FrontOrderType および市場コードとの組み合わせに制限があるため、必要に応じて仕様書の対応表を参照する。
TimeInForce int `json:"TimeInForce" validate:"required"`
// Side は売買区分。1:売、2:買。
Side string `json:"Side" validate:"required"`
// Qty は注文数量。
Qty int `json:"Qty" validate:"required"`
// ClosePositionOrder は決済順序。0:日付古→損益高、1:日付古→損益低、2:日付新→損益高、3:日付新→損益低、
// 4:損益高→日付古、5:損益高→日付新、6:損益低→日付古、7:損益低→日付新。ClosePositions との同時指定は不可。
ClosePositionOrder int `json:"ClosePositionOrder,omitempty"`
// ClosePositions は返済建玉を個別指定する。ClosePositionOrder と排他。
ClosePositions []struct {
HoldID string `json:"HoldID,omitempty"` // 返済建玉ID。
Qty int `json:"Qty,omitempty"` // 返済建玉数量。
} `json:"ClosePositions,omitempty"`
// FrontOrderType は執行条件。18:引成(TimeInForce は FAK のみ)、20:指値、28:引指(TimeInForce は FAS のみ)、
// 30:逆指値(AfterHitPrice 側で価格を指定)、120:成行(Price は 0 を指定)。
FrontOrderType int `json:"FrontOrderType" validate:"required"`
// Price は注文価格。成行や引成では 0 を指定し、その他は発注したい単価を設定する。
Price float64 `json:"Price" validate:"required"`
// ExpireDay は注文有効期限の日付。yyyyMMdd 形式、0 は「本日」扱い(市場の引け後は翌取引所営業日、休前日は休日明け)。
// 日替わりは kabu ステーション側の日付更新タイミングに従う。
ExpireDay int `json:"ExpireDay" validate:"required"`
// ReverseLimitOrder は FrontOrderType=逆指値のときに設定する条件。
ReverseLimitOrder struct {
TriggerPrice float64 `json:"TriggerPrice,omitempty"` // TriggerPrice は逆指値の発動価格。未設定や数値以外はエラー。
UnderOver int `json:"UnderOver,omitempty"` // UnderOver は発動条件。1:以下、2:以上。未設定や 1/2 以外はエラー。
AfterHitOrderType int `json:"AfterHitOrderType,omitempty"` // AfterHitOrderType はヒット後の執行条件。1:成行、2:指値。日通しでは 2 のみ有効、日中/夜間では 1 または 2 を指定。逆指値成行は TimeInForce=FAK、逆指値指値は TimeInForce=FAS を指定する。
AfterHitPrice float64 `json:"AfterHitPrice,omitempty"` // AfterHitPrice はヒット後の価格。成行なら 0、指値なら単価を指定。未設定や数値以外はエラー。
} `json:"ReverseLimitOrder,omitempty"`
}
ReqPostOrderSendorderFuture は **POST /sendorder/future** のリクエストボディ。
概要:
- 先物銘柄の新規・返済注文を発注する。
- X-API-KEY ヘッダーによる認証が必須。
- 同一銘柄での同時発注は 5 件程度までを推奨。
type ReqPostOrderSendorderOption ¶
type ReqPostOrderSendorderOption struct {
// 銘柄コード<br>※取引最終日に「オプション銘柄コード取得」でDerivMonthに0(直近限月)を指定した場合、日中・夜間の時間帯に関わらず、取引最終日を迎える限月の銘柄コードを返します。取引最終日を迎える銘柄の取引は日中取引をもって終了となりますので、ご注意ください。
Symbol string `json:"Symbol" validate:"required"`
// 市場コード <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>2</td> <td>日通し</td> </tr> <tr> <td>23</td> <td>日中</td> </tr> <tr> <td>24</td> <td>夜間</td> </tr> </tbody> </table>
Exchange int `json:"Exchange" validate:"required"`
// 取引区分 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>新規</td> </tr> <tr> <td>2</td> <td>返済</td> </tr> </tbody> </table>
TradeType int `json:"TradeType" validate:"required"`
// 有効期間条件 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>FAS</td> </tr> <tr> <td>2</td> <td>FAK</td> </tr> <tr> <td>3</td> <td>FOK</td> </tr> </tbody> </table> ※執行条件(FrontOrderType)、有効期限条件(TimeInForce)、市場コード(Exchange)で選択できる組み合わせは下表のようになります。 <table> <thead> <tr> <th rowspan="2">執行条件</th> <th rowspan="2">有効期間条件</th> <th colspan="3">市場コード</th> </tr> <tr> <th>日中</th> <th>夜間</th> <th>日通し</th> </tr> </thead> <tbody> <tr> <td>指値</td> <td>FAS</td> <td>●</td> <td>●</td> <td>●</td> </tr> <tr> <td>指値</td> <td>FAK</td> <td>●</td> <td>●</td> <td>-</td> </tr> <tr> <td>指値</td> <td>FOK</td> <td>●</td> <td>●</td> <td>-</td> </tr> <tr> <td>成行</td> <td>FAK</td> <td>●</td> <td>●</td> <td>-</td> </tr> <tr> <td>成行</td> <td>FOK</td> <td>●</td> <td>●</td> <td>-</td> </tr> <tr> <td>逆指値(指値)</td> <td>FAK</td> <td>●</td> <td>●</td> <td>●</td> </tr> <tr> <td>逆指値(成行)</td> <td>FAK</td> <td>●</td> <td>●</td> <td>-</td> </tr> <tr> <td>引成</td> <td>FAK</td> <td>●</td> <td>●</td> <td>-</td> </tr> <tr> <td>引指</td> <td>FAS</td> <td>●</td> <td>●</td> <td>-</td> </tr> </tbody> </table>
TimeInForce int `json:"TimeInForce" validate:"required"`
// 売買区分 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>売</td> </tr> <tr> <td>2</td> <td>買</td> </tr> </tbody> </table>
Side string `json:"Side" validate:"required"`
// 注文数量
Qty int `json:"Qty" validate:"required"`
// 決済順序<br>※ClosePositionOrderとClosePositionsはどちらか一方のみ指定可能。<br>※ClosePositionOrderとClosePositionsを両方指定した場合、エラー。 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>0</td> <td>日付(古い順)、損益(高い順)</td> </tr> <tr> <td>1</td> <td>日付(古い順)、損益(低い順)</td> </tr> <tr> <td>2</td> <td>日付(新しい順)、損益(高い順)</td> </tr> <tr> <td>3</td> <td>日付(新しい順)、損益(低い順)</td> </tr> <tr> <td>4</td> <td>損益(高い順)、日付(古い順)</td> </tr> <tr> <td>5</td> <td>損益(高い順)、日付(新しい順)</td> </tr> <tr> <td>6</td> <td>損益(低い順)、日付(古い順)</td> </tr> <tr> <td>7</td> <td>損益(低い順)、日付(新しい順)</td> </tr> </tbody> </table>
ClosePositionOrder int `json:"ClosePositionOrder"`
// 返済建玉指定<br>※ClosePositionOrderとClosePositionsはどちらか一方のみ指定可能。<br>※ClosePositionOrderとClosePositionsを両方指定した場合、エラー。
ClosePositions []struct {
HoldID string `json:"HoldID,omitempty"` // 返済建玉ID
Qty int `json:"Qty,omitempty"` // 返済建玉数量
} `json:"ClosePositions"`
// 執行条件 <table> <thead> <tr> <th>定義値</th> <th>説明</th> <th>”Price”の指定</th> </tr> </thead> <tbody> <tr> <td>18</td> <td>引成(派生)<br>※TimeInForceは、「FAK」のみ有効</td> <td>0</td> </tr> <tr> <td>20</td> <td>指値</td> <td>発注したい金額</td> </tr> <tr> <td>28</td> <td>引指(派生)<br>※TimeInForceは、「FAS」のみ有効</td> <td>発注したい金額</td> </tr> <tr> <td>30</td> <td>逆指値</td> <td>指定なし<br>※AfterHitPriceで指定ください</td> </tr> <tr> <td>120</td> <td>成行(マーケットオーダー)</td> <td>0</td> </tr> </tbody> </table>
FrontOrderType int `json:"FrontOrderType" validate:"required"`
// 注文価格<br>※FrontOrderTypeで成行を指定した場合、0を指定する。<br>※詳細について、”FrontOrderType”をご確認ください。
Price float64 `json:"Price" validate:"required"`
// 注文有効期限<br> yyyyMMdd形式。<br> 「0」を指定すると、kabuステーション上の発注画面の「本日」に対応する日付として扱います。<br> 「本日」は直近の注文可能日となり、以下のように設定されます。<br> その市場の引けまでの間 : 当日<br> その市場の引け後 : 翌取引所営業日<br> その市場の休前日 : 休日明けの取引所営業日<br> ※ 日替わりはkabuステーションが日付変更通知を受信したタイミングです。<br> ※ 日通しの場合、夜間取引の引け後に日付が更新されます。
ExpireDay int `json:"ExpireDay" validate:"required"`
// 逆指値条件<br> ※FrontOrderTypeで逆指値を指定した場合のみ必須。
ReverseLimitOrder struct {
TriggerPrice float64 `json:"TriggerPrice,omitempty"` // トリガ価格<br> ※未設定の場合はエラーになります。<br> ※数字以外が設定された場合はエラーになります。
UnderOver int `json:"UnderOver,omitempty"` // 以上/以下<br> ※未設定の場合はエラーになります。<br> ※1、2以外が指定された場合はエラーになります。 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>以下</td> </tr> <tr> <td>2</td> <td>以上</td> </tr> </tbody> </table>
AfterHitOrderType int `json:"AfterHitOrderType,omitempty"` // ヒット後執行条件<br> ※未設定の場合はエラーになります。<br> ※日通の注文で2以外が指定された場合はエラーになります。<br> ※日中、夜間の注文で1、2以外が指定された場合はエラーになります。<br> ※逆指値(成行)で有効期間条件(TimeInForce)にFAK以外を指定された場合はエラーになります。<br> ※逆指値(指値)で有効期間条件(TimeInForce)にFAS以外を指定された場合はエラーになります。 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>成行</td> </tr> <tr> <td>2</td> <td>指値</td> </tr> </tbody> </table>
AfterHitPrice float64 `json:"AfterHitPrice,omitempty"` // ヒット後注文価格<br> ※未設定の場合はエラーになります。<br> ※数字以外が設定された場合はエラーになります。<br><br> ヒット後執行条件に従い、下記のようにヒット後注文価格を設定してください。 <table> <thead> <tr> <th>ヒット後執行条件</th> <th>設定価格</th> </tr> </thead> <tbody> <tr> <td>成行</td> <td>0</td> </tr> <tr> <td>指値</td> <td>指値の単価</td> </tr> </tbody> </table>
} `json:"ReverseLimitOrder"`
}
ReqPostOrderSendorderOption は **POST /sendorder/option** のリクエスト。
### 概要 注文発注(オプション)
- 認証: 必須(X-API-KEY ヘッダー)
type ReqPutOrderCancelorder ¶
type ReqPutOrderCancelorder struct {
// 注文番号<br>sendorderのレスポンスで受け取るOrderID。
OrderId string `json:"OrderId" validate:"required"`
}
ReqPutOrderCancelorder は **PUT /cancelorder** のリクエスト。
### 概要 注文取消
- 認証: 必須(X-API-KEY ヘッダー)
type ReqPutRegisterRegister ¶
type ReqPutRegisterRegister struct {
Symbols []struct {
Symbol string `json:"Symbol,omitempty"` // 銘柄コード
// Exchange は市場コード。
// - 1: 東証
// - 3: 名証
// - 5: 福証
// - 6: 札証
// - 2: 日通し
// - 23: 日中
// - 24: 夜間
Exchange int `json:"Exchange,omitempty"`
} `json:"Symbols"`
}
ReqPutRegisterRegister は PUT /register のリクエストボディ。
- 用途: PUSH 配信対象の銘柄を登録する
- 認証: 必須(X-API-KEY ヘッダー)
type ReqPutRegisterUnregister ¶
type ReqPutRegisterUnregister struct {
// 為替銘柄を登録解除する場合の指定:
// - Symbol: 通貨A/通貨B(例: EUR/USD)
// - Exchange: 300
Symbols []struct {
Symbol string `json:"Symbol,omitempty"` // 銘柄コード
// Exchange は市場コード。
// - 1: 東証
// - 3: 名証
// - 5: 福証
// - 6: 札証
// - 2: 日通し
// - 23: 日中
// - 24: 夜間
// - 300: 為替(通貨ペア)
Exchange int `json:"Exchange,omitempty"`
} `json:"Symbols"`
}
ReqPutRegisterUnregister は PUT /unregister のリクエストボディ。
- 用途: PUSH 登録した銘柄を個別に解除する
- 認証: 必須(X-API-KEY ヘッダー)
type ReqPutRegisterUnregisterAll ¶
type ReqPutRegisterUnregisterAll struct {
}
ReqPutRegisterUnregisterAll は PUT /unregister/all のリクエストボディ。
- 用途: 登録済み銘柄を全件解除する
- 認証: 必須(X-API-KEY ヘッダー)
type ResGetInfoApisoftlimit ¶
type ResGetInfoApisoftlimit struct {
// 現物のワンショット上限 ※単位は万円
Stock float64 `json:"Stock,omitempty"`
// 信用のワンショット上限 ※単位は万円
Margin float64 `json:"Margin,omitempty"`
// 先物のワンショット上限 ※単位は枚
Future float64 `json:"Future,omitempty"`
// ミニ先物のワンショット上限 ※単位は枚
FutureMini float64 `json:"FutureMini,omitempty"`
// マイクロ先物のワンショット上限 ※単位は枚
FutureMicro float64 `json:"FutureMicro,omitempty"`
// オプションのワンショット上限 ※単位は枚
Option float64 `json:"Option,omitempty"`
// ミニオプションのワンショット上限 ※単位は枚
MiniOption float64 `json:"MiniOption,omitempty"`
// kabuステーションのバージョン
KabuSVersion string `json:"KabuSVersion,omitempty"`
}
ResGetInfoApisoftlimit は **GET /apisoftlimit** のレスポンス。
ソフトリミット
func GetInfoApisoftlimit ¶
func GetInfoApisoftlimit(req ReqGetInfoApisoftlimit) (code int, res ResGetInfoApisoftlimit, err error)
GetInfoApisoftlimit は **GET /apisoftlimit** を呼び出してソフトリミット値を取得します。
機能:
- kabuステーション API に設定された各種ソフトリミット値を取得する。
引数:
- req (ReqGetInfoApisoftlimit): 空のリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetInfoApisoftlimit): ソフトリミットの値。
- err (error): 通信エラーまたは APIError。
type ResGetInfoBoardSymbol ¶
type ResGetInfoBoardSymbol struct {
// 銘柄コード
Symbol string `json:"Symbol,omitempty"`
// 銘柄名
SymbolName string `json:"SymbolName,omitempty"`
// 市場コード ※株式・先物・オプション銘柄の場合のみ 定義値 説明 1 東証 3 名証 5 福証 6 札証 2 日通し 23 日中 24 夜間
Exchange int `json:"Exchange,omitempty"`
// 市場名称 ※株式・先物・オプション銘柄の場合のみ
ExchangeName string `json:"ExchangeName,omitempty"`
// 現値
CurrentPrice float64 `json:"CurrentPrice,omitempty"`
// 現値時刻
CurrentPriceTime string `json:"CurrentPriceTime,omitempty"`
// 現値前値比較 定義値 説明 0000 事象なし 0056 変わらず 0057 UP 0058 DOWN 0059 中断板寄り後の初値 0060 ザラバ引け 0061 板寄り引け 0062 中断引け 0063 ダウン引け 0064 逆転終値 0066 特別気配引け 0067 一時留保引け 0068 売買停止引け 0069 サーキットブレーカ引け 0431 ダイナミックサーキットブレーカ引け
CurrentPriceChangeStatus string `json:"CurrentPriceChangeStatus,omitempty"`
// 現値ステータス 定義値 説明 1 現値 2 不連続歩み 3 板寄せ 4 システム障害 5 中断 6 売買停止 7 売買停止・システム停止解除 8 終値 9 システム停止 10 概算値 11 参考値 12 サーキットブレイク実施中 13 システム障害解除 14 サーキットブレイク解除 15 中断解除 16 一時留保中 17 一時留保解除 18 ファイル障害 19 ファイル障害解除 20 Spread/Strategy 21 ダイナミックサーキットブレイク発動 22 ダイナミックサーキットブレイク解除 23 板寄せ約定
CurrentPriceStatus int `json:"CurrentPriceStatus,omitempty"`
// 計算用現値
CalcPrice float64 `json:"CalcPrice,omitempty"`
// 前日終値
PreviousClose float64 `json:"PreviousClose,omitempty"`
// 前日終値日付
PreviousCloseTime string `json:"PreviousCloseTime,omitempty"`
// 前日比
ChangePreviousClose float64 `json:"ChangePreviousClose,omitempty"`
// 騰落率
ChangePreviousClosePer float64 `json:"ChangePreviousClosePer,omitempty"`
// 始値
OpeningPrice float64 `json:"OpeningPrice,omitempty"`
// 始値時刻
OpeningPriceTime string `json:"OpeningPriceTime,omitempty"`
// 高値
HighPrice float64 `json:"HighPrice,omitempty"`
// 高値時刻
HighPriceTime string `json:"HighPriceTime,omitempty"`
// 安値
LowPrice float64 `json:"LowPrice,omitempty"`
// 安値時刻
LowPriceTime string `json:"LowPriceTime,omitempty"`
// 売買高 ※株式・先物・オプション銘柄の場合のみ
TradingVolume float64 `json:"TradingVolume,omitempty"`
// 売買高時刻 ※株式・先物・オプション銘柄の場合のみ
TradingVolumeTime string `json:"TradingVolumeTime,omitempty"`
// 売買高加重平均価格(VWAP) ※株式・先物・オプション銘柄の場合のみ
VWAP float64 `json:"VWAP,omitempty"`
// 売買代金 ※株式・先物・オプション銘柄の場合のみ
TradingValue float64 `json:"TradingValue,omitempty"`
// 最良売気配数量 ※① ※株式・先物・オプション銘柄の場合のみ
BidQty float64 `json:"BidQty,omitempty"`
// 最良売気配値段 ※① ※株式・先物・オプション銘柄の場合のみ
BidPrice float64 `json:"BidPrice,omitempty"`
// 最良売気配時刻 ※① ※株式銘柄の場合のみ
BidTime string `json:"BidTime,omitempty"`
// 最良売気配フラグ ※① ※株式・先物・オプション銘柄の場合のみ 定義値 説明 0000 事象なし 0101 一般気配 0102 特別気配 0103 注意気配 0107 寄前気配 0108 停止前特別気配 0109 引け後気配 0116 寄前気配約定成立ポイントなし 0117 寄前気配約定成立ポイントあり 0118 連続約定気配 0119 停止前の連続約定気配 0120 買い上がり売り下がり中
BidSign string `json:"BidSign,omitempty"`
// 売成行数量 ※株式銘柄の場合のみ
MarketOrderSellQty float64 `json:"MarketOrderSellQty,omitempty"`
// 売気配数量1本目
Sell1 struct {
Time string `json:"Time,omitempty"` // 時刻<br>※株式銘柄の場合のみ
Sign string `json:"Sign,omitempty"` // 気配フラグ<br>※株式・先物・オプション銘柄の場合のみ <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>0000</td> <td>事象なし</td> </tr> <tr> <td>0101</td> <td>一般気配</td> </tr> <tr> <td>0102</td> <td>特別気配</td> </tr> <tr> <td>0103</td> <td>注意気配</td> </tr> <tr> <td>0107</td> <td>寄前気配</td> </tr> <tr> <td>0108</td> <td>停止前特別気配</td> </tr> <tr> <td>0109</td> <td>引け後気配</td> </tr> <tr> <td>0116</td> <td>寄前気配約定成立ポイントなし</td> </tr> <tr> <td>0117</td> <td>寄前気配約定成立ポイントあり</td> </tr> <tr> <td>0118</td> <td>連続約定気配</td> </tr> <tr> <td>0119</td> <td>停止前の連続約定気配</td> </tr> <tr> <td>0120</td> <td>買い上がり売り下がり中</td> </tr> </tbody> </table>
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Sell1,omitempty"`
// 売気配数量2本目
Sell2 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Sell2,omitempty"`
// 売気配数量3本目
Sell3 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Sell3,omitempty"`
// 売気配数量4本目
Sell4 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Sell4,omitempty"`
// 売気配数量5本目
Sell5 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Sell5,omitempty"`
// 売気配数量6本目
Sell6 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Sell6,omitempty"`
// 売気配数量7本目
Sell7 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Sell7,omitempty"`
// 売気配数量8本目
Sell8 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Sell8,omitempty"`
// 売気配数量9本目
Sell9 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Sell9,omitempty"`
// 売気配数量10本目
Sell10 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Sell10,omitempty"`
// 最良買気配数量 ※① ※株式・先物・オプション銘柄の場合のみ
AskQty float64 `json:"AskQty,omitempty"`
// 最良買気配値段 ※① ※株式・先物・オプション銘柄の場合のみ
AskPrice float64 `json:"AskPrice,omitempty"`
// 最良買気配時刻 ※① ※株式銘柄の場合のみ
AskTime string `json:"AskTime,omitempty"`
// 最良買気配フラグ ※① ※株式・先物・オプション銘柄の場合のみ 定義値 説明 0000 事象なし 0101 一般気配 0102 特別気配 0103 注意気配 0107 寄前気配 0108 停止前特別気配 0109 引け後気配 0116 寄前気配約定成立ポイントなし 0117 寄前気配約定成立ポイントあり 0118 連続約定気配 0119 停止前の連続約定気配 0120 買い上がり売り下がり中
AskSign string `json:"AskSign,omitempty"`
// 買成行数量 ※株式銘柄の場合のみ
MarketOrderBuyQty float64 `json:"MarketOrderBuyQty,omitempty"`
// 買気配数量1本目
Buy1 struct {
Time string `json:"Time,omitempty"` // 時刻<br>※株式銘柄の場合のみ
Sign string `json:"Sign,omitempty"` // 気配フラグ<br>※株式・先物・オプション銘柄の場合のみ <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>0000</td> <td>事象なし</td> </tr> <tr> <td>0101</td> <td>一般気配</td> </tr> <tr> <td>0102</td> <td>特別気配</td> </tr> <tr> <td>0103</td> <td>注意気配</td> </tr> <tr> <td>0107</td> <td>寄前気配</td> </tr> <tr> <td>0108</td> <td>停止前特別気配</td> </tr> <tr> <td>0109</td> <td>引け後気配</td> </tr> <tr> <td>0116</td> <td>寄前気配約定成立ポイントなし</td> </tr> <tr> <td>0117</td> <td>寄前気配約定成立ポイントあり</td> </tr> <tr> <td>0118</td> <td>連続約定気配</td> </tr> <tr> <td>0119</td> <td>停止前の連続約定気配</td> </tr> <tr> <td>0120</td> <td>買い上がり売り下がり中</td> </tr> </tbody> </table>
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Buy1,omitempty"`
// 買気配数量2本目
Buy2 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Buy2,omitempty"`
// 買気配数量3本目
Buy3 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Buy3,omitempty"`
// 買気配数量4本目
Buy4 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Buy4,omitempty"`
// 買気配数量5本目
Buy5 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Buy5,omitempty"`
// 買気配数量6本目
Buy6 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Buy6,omitempty"`
// 買気配数量7本目
Buy7 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Buy7,omitempty"`
// 買気配数量8本目
Buy8 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Buy8,omitempty"`
// 買気配数量9本目
Buy9 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Buy9,omitempty"`
// 買気配数量10本目
Buy10 struct {
Price float64 `json:"Price,omitempty"` // 値段<br>※株式・先物・オプション銘柄の場合のみ
Qty float64 `json:"Qty,omitempty"` // 数量<br>※株式・先物・オプション銘柄の場合のみ
} `json:"Buy10,omitempty"`
// OVER気配数量 ※株式銘柄の場合のみ
OverSellQty float64 `json:"OverSellQty,omitempty"`
// UNDER気配数量 ※株式銘柄の場合のみ
UnderBuyQty float64 `json:"UnderBuyQty,omitempty"`
// 時価総額 ※株式銘柄の場合のみ
TotalMarketValue float64 `json:"TotalMarketValue,omitempty"`
// 清算値 ※先物銘柄の場合のみ
ClearingPrice float64 `json:"ClearingPrice,omitempty"`
// インプライド・ボラティリティ ※オプション銘柄かつ日通しの場合のみ
IV float64 `json:"IV,omitempty"`
// ガンマ ※オプション銘柄かつ日通しの場合のみ
Gamma float64 `json:"Gamma,omitempty"`
// セータ ※オプション銘柄かつ日通しの場合のみ
Theta float64 `json:"Theta,omitempty"`
// ベガ ※オプション銘柄かつ日通しの場合のみ
Vega float64 `json:"Vega,omitempty"`
// デルタ ※オプション銘柄かつ日通しの場合のみ
Delta float64 `json:"Delta,omitempty"`
// 銘柄種別 定義値 説明 0 指数 1 現物 101 日経225先物 103 日経225OP 107 TOPIX先物 121 JPX400先物 144 NYダウ 145 日経平均VI 154 グロース250先物 155 TOPIX_REIT 171 TOPIX CORE30 901 日経平均225ミニ先物 907 TOPIXミニ先物
SecurityType int `json:"SecurityType,omitempty"`
}
ResGetInfoBoardSymbol は **GET /board/{symbol}** のレスポンス。
時価情報・板情報
func GetInfoBoardSymbol ¶
func GetInfoBoardSymbol(req ReqGetInfoBoardSymbol) (code int, res ResGetInfoBoardSymbol, err error)
GetInfoBoardSymbol は **GET /board/{symbol}** を呼び出して時価情報・板情報を取得します。
機能:
- 指定した銘柄の最新気配や約定価格、板情報を取得する。
引数:
- req (ReqGetInfoBoardSymbol): 銘柄コードと市場コードを含むパスパラメータ。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetInfoBoardSymbol): 取得した時価・板情報。
- err (error): 通信エラーまたは APIError。
type ResGetInfoExchangeSymbol ¶
type ResGetInfoExchangeSymbol struct {
// 通貨
Symbol string `json:"Symbol,omitempty"`
// BID
BidPrice float64 `json:"BidPrice,omitempty"`
// SP
Spread float64 `json:"Spread,omitempty"`
// ASK
AskPrice float64 `json:"AskPrice,omitempty"`
// 前日比
Change float64 `json:"Change,omitempty"`
// 時刻 ※HH:mm:ss形式
Time string `json:"Time,omitempty"`
}
ResGetInfoExchangeSymbol は **GET /exchange/{symbol}** のレスポンス。
為替情報
func GetInfoExchangeSymbol ¶
func GetInfoExchangeSymbol(req ReqGetInfoExchangeSymbol) (code int, res ResGetInfoExchangeSymbol, err error)
GetInfoExchangeSymbol は **GET /exchange/{symbol}** を呼び出して為替情報を取得します。
機能:
- 指定した通貨ペアの気配値や現在値など、マネービューに相当する為替情報を取得する。
引数:
- req (ReqGetInfoExchangeSymbol): 通貨ペアと市場コードをパスパラメータで指定するリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetInfoExchangeSymbol): 取得した為替情報。
- err (error): 通信エラーまたは APIError。
type ResGetInfoMarginMarginpremiumSymbol ¶
type ResGetInfoMarginMarginpremiumSymbol struct {
Symbol string `json:"Symbol,omitempty"`
GeneralMargin struct {
MarginPremiumType int `json:"MarginPremiumType,omitempty"` // プレミアム料入力区分 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>null</td> <td>一般信用(長期)非対応銘柄</td> </tr> <tr> <td>0</td> <td>プレミアム料がない銘柄</td> </tr> <tr> <td>1</td> <td>プレミアム料が固定の銘柄</td> </tr> <tr> <td>2</td> <td>プレミアム料が入札で決定する銘柄</td> </tr> </tbody> </table>
MarginPremium float64 `json:"MarginPremium,omitempty"` // 確定プレミアム料<br> ※入札銘柄の場合、入札受付中は随時更新します。受付時間外は、確定したプレミアム料を返します。<br> ※非入札銘柄の場合、常に固定値を返します。<br> ※信用取引不可の場合、nullを返します。<br> ※19:30~翌営業日のプレミアム料になります。
UpperMarginPremium float64 `json:"UpperMarginPremium,omitempty"` // 上限プレミアム料<br> ※プレミアム料がない場合は、nullを返します。
LowerMarginPremium float64 `json:"LowerMarginPremium,omitempty"` // 下限プレミアム料<br> ※プレミアム料がない場合は、nullを返します。
TickMarginPremium float64 `json:"TickMarginPremium,omitempty"` // プレミアム料刻値<br> ※入札可能銘柄以外は、nullを返します。
} `json:"GeneralMargin,omitempty"`
DayTrade struct {
MarginPremiumType int `json:"MarginPremiumType,omitempty"` // プレミアム料入力区分 <table> <thead> <tr> <th>定義値</th> <th>説明</th> </tr> </thead> <tbody> <tr> <td>null</td> <td>一般信用(デイトレ)非対応銘柄</td> </tr> <tr> <td>0</td> <td>プレミアム料がない銘柄</td> </tr> <tr> <td>1</td> <td>プレミアム料が固定の銘柄</td> </tr> <tr> <td>2</td> <td>プレミアム料が入札で決定する銘柄</td> </tr> </tbody> </table>
MarginPremium float64 `json:"MarginPremium,omitempty"` // 確定プレミアム料<br> ※入札銘柄の場合、入札受付中は随時更新します。受付時間外は、確定したプレミアム料を返します。<br> ※非入札銘柄の場合、常に固定値を返します。<br> ※信用取引不可の場合、nullを返します。<br> ※19:30~翌営業日のプレミアム料になります。
UpperMarginPremium float64 `json:"UpperMarginPremium,omitempty"` // 上限プレミアム料<br> ※プレミアム料がない場合は、nullを返します。
LowerMarginPremium float64 `json:"LowerMarginPremium,omitempty"` // 下限プレミアム料<br> ※プレミアム料がない場合は、nullを返します。
TickMarginPremium float64 `json:"TickMarginPremium,omitempty"` // プレミアム料刻値<br> ※入札可能銘柄以外は、nullを返します。
} `json:"DayTrade,omitempty"`
}
ResGetInfoMarginMarginpremiumSymbol は **GET /margin/marginpremium/{symbol}** のレスポンス。
プレミアム料取得
func GetInfoMarginMarginpremiumSymbol ¶
func GetInfoMarginMarginpremiumSymbol(req ReqGetInfoMarginMarginpremiumSymbol) (code int, res ResGetInfoMarginMarginpremiumSymbol, err error)
GetInfoMarginMarginpremiumSymbol は **GET /margin/marginpremium/{symbol}** を呼び出してプレミアム料を取得します。
機能:
- 指定した銘柄のプレミアム料や日計りに関する情報を取得する。
引数:
- req (ReqGetInfoMarginMarginpremiumSymbol): 銘柄コードと市場コードを含むパスパラメータ。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetInfoMarginMarginpremiumSymbol): プレミアム料情報。
- err (error): 通信エラーまたは APIError。
type ResGetInfoOrders ¶
type ResGetInfoOrders []struct {
// 注文番号
ID string `json:"ID,omitempty"`
// 状態 ※OrderState と同一。1:待機 2:処理中 3:処理済 4:訂正取消送信中 5:終了
State int `json:"State,omitempty"`
// 注文状態 ※State と同一。1:待機 2:処理中 3:処理済 4:訂正取消送信中 5:終了
OrderState int `json:"OrderState,omitempty"`
// 執行条件 1:ザラバ 2:寄り 3:引け 4:不成 5:対当指値 6:IOC
OrdType int `json:"OrdType,omitempty"`
// 受注日時
RecvTime string `json:"RecvTime,omitempty"`
// 銘柄コード
Symbol string `json:"Symbol,omitempty"`
// 銘柄名
SymbolName string `json:"SymbolName,omitempty"`
// 市場コード 1:東証 3:名証 5:福証 6:札証 9:SOR 27:東証+ 2:日通し 23:日中 24:夜間
Exchange int `json:"Exchange,omitempty"`
// 市場名
ExchangeName string `json:"ExchangeName,omitempty"`
// 有効期間条件 ※先物・オプション銘柄の場合のみ 1:FAS 2:FAK 3:FOK
TimeInForce int `json:"TimeInForce,omitempty"`
// 値段
Price float64 `json:"Price,omitempty"`
// 発注数量 ※期限切れや失効でもゼロにはならない
OrderQty float64 `json:"OrderQty,omitempty"`
// 約定数量
CumQty float64 `json:"CumQty,omitempty"`
// 売買区分 1:売 2:買
Side string `json:"Side,omitempty"`
// 取引区分 2:新規 3:返済
CashMargin int `json:"CashMargin,omitempty"`
// 口座種別 2:一般 4:特定 12:法人
AccountType int `json:"AccountType,omitempty"`
// 受渡区分 2:お預り金 3:auマネーコネクト
DelivType int `json:"DelivType,omitempty"`
// 注文有効期限 yyyyMMdd 形式
ExpireDay int `json:"ExpireDay,omitempty"`
// 信用取引区分 1:制度信用 2:一般信用(長期) 3:一般信用(デイトレ)
MarginTradeType int `json:"MarginTradeType,omitempty"`
// プレミアム料 ※信用を注文した際に表示
MarginPremium float64 `json:"MarginPremium,omitempty"`
// 注文詳細
Details []struct {
// 注文明細レコードの生成順序。通番ではないが大小による順序は維持される。
SeqNum int `json:"SeqNum,omitempty"`
// 注文詳細番号
ID string `json:"ID,omitempty"`
// 明細種別 1:受付 2:繰越 3:期限切れ 4:発注 5:訂正 6:取消 7:失効 8:約定
RecType int `json:"RecType,omitempty"`
// 取引所番号
ExchangeID string `json:"ExchangeID,omitempty"`
// 状態 1:待機 2:処理中 3:処理済 4:エラー 5:削除済み
State int `json:"State,omitempty"`
// 処理時刻
TransactTime string `json:"TransactTime,omitempty"`
// 執行条件 null:取消 / 0:期限切れ・失効・約定 / 1:ザラバ / 2:寄り / 3:引け / 4:不成 / 5:対当指値 / 6:IOC
OrdType int `json:"OrdType,omitempty"`
// 値段
Price float64 `json:"Price,omitempty"`
// 数量
Qty float64 `json:"Qty,omitempty"`
// 約定番号
ExecutionID string `json:"ExecutionID,omitempty"`
// 約定日時
ExecutionDay string `json:"ExecutionDay,omitempty"`
// 受渡日
DelivDay int `json:"DelivDay,omitempty"`
// 手数料 ※明細種別が約定(RecType=8)の場合に設定
Commission float64 `json:"Commission,omitempty"`
// 手数料消費税 ※明細種別が約定(RecType=8)の場合に設定
CommissionTax float64 `json:"CommissionTax,omitempty"`
} `json:"Details,omitempty"`
}
ResGetInfoOrders は **GET /orders** のレスポンス。
注文約定照会
func GetInfoOrders ¶
func GetInfoOrders(req ReqGetInfoOrders) (code int, res ResGetInfoOrders, err error)
GetInfoOrders は **GET /orders** を呼び出して注文・約定状況を取得します。
機能:
- 商品区分や注文番号などで絞り込み、現在の注文一覧を取得する。
引数:
- req (ReqGetInfoOrders): 注文照会の絞り込み条件。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetInfoOrders): 注文・約定に関する情報。
- err (error): 通信エラーまたは APIError。
type ResGetInfoPositions ¶
type ResGetInfoPositions struct {
}
ResGetInfoPositions は **GET /positions** のレスポンス。
残高照会
func GetInfoPositions ¶
func GetInfoPositions(req ReqGetInfoPositions) (code int, res ResGetInfoPositions, err error)
GetInfoPositions は **GET /positions** を呼び出して建玉残高を取得します。
機能:
- 商品区分や銘柄、保有区分でフィルタし、保有中の建玉一覧を取得する。
引数:
- req (ReqGetInfoPositions): 残高照会の絞り込み条件。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetInfoPositions): 建玉残高の一覧。
- err (error): 通信エラーまたは APIError。
type ResGetInfoPrimaryexchangeSymbol ¶
type ResGetInfoPrimaryexchangeSymbol struct {
// 銘柄コード ※対象商品は、株式のみ
Symbol string `json:"Symbol,omitempty"`
// 優先市場 定義値 説明 1 東証 3 名証 5 福証 6 札証
PrimaryExchange int `json:"PrimaryExchange,omitempty"`
}
ResGetInfoPrimaryexchangeSymbol は **GET /primaryexchange/{symbol}** のレスポンス。
優先市場
func GetInfoPrimaryexchangeSymbol ¶
func GetInfoPrimaryexchangeSymbol(req ReqGetInfoPrimaryexchangeSymbol) (code int, res ResGetInfoPrimaryexchangeSymbol, err error)
GetInfoPrimaryexchangeSymbol は **GET /primaryexchange/{symbol}** を呼び出して株式の優先市場を取得します。
機能:
- 指定した株式銘柄について、優先する市場コードを取得する。
引数:
- req (ReqGetInfoPrimaryexchangeSymbol): 銘柄コードを含むパスパラメータ。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetInfoPrimaryexchangeSymbol): 優先市場情報。
- err (error): 通信エラーまたは APIError。
type ResGetInfoRanking ¶
type ResGetInfoRanking struct {
}
ResGetInfoRanking は **GET /ranking** のレスポンス。
詳細ランキング
func GetInfoRanking ¶
func GetInfoRanking(req ReqGetInfoRanking) (code int, res ResGetInfoRanking, err error)
GetInfoRanking は **GET /ranking** を呼び出して各種ランキング情報を取得します。
機能:
- 詳細ランキング画面と同様に、出来高や値上がり率などのランキングを取得する。
引数:
- req (ReqGetInfoRanking): 取得するランキングの種別などを指定するリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetInfoRanking): 取得したランキング情報。
- err (error): 通信エラーまたは APIError。
type ResGetInfoRegulationsSymbol ¶
type ResGetInfoRegulationsSymbol struct {
// 銘柄コード ※対象商品は、株式のみ
Symbol string `json:"Symbol,omitempty"`
// 規制情報
RegulationsInfo []struct {
Exchange int `json:"Exchange,omitempty"` // 規制市場 <table> <thead> <tr> <th>定義値</th> <th>内容</th> </tr> </thead> <tbody> <tr> <td>0</td> <td>全対象</td> </tr> <tr> <td>1</td> <td>東証</td> </tr> <tr> <td>3</td> <td>名証</td> </tr> <tr> <td>5</td> <td>福証</td> </tr> <tr> <td>6</td> <td>札証</td> </tr> <tr> <td>9</td> <td>SOR</td> </tr> <tr> <td>10</td> <td>CXJ</td> </tr> <tr> <td>21</td> <td>JNX</td> </tr> </tbody> </table>
Product int `json:"Product,omitempty"` // 規制取引区分<br> ※空売り規制の場合、「4:新規」 <table> <thead> <tr> <th>定義値</th> <th>内容</th> </tr> </thead> <tbody> <tr> <td>0</td> <td>全対象</td> </tr> <tr> <td>1</td> <td>現物</td> </tr> <tr> <td>2</td> <td>信用新規(制度)</td> </tr> <tr> <td>3</td> <td>信用新規(一般)</td> </tr> <tr> <td>4</td> <td>新規</td> </tr> <tr> <td>5</td> <td>信用返済(制度)</td> </tr> <tr> <td>6</td> <td>信用返済(一般)</td> </tr> <tr> <td>7</td> <td>返済</td> </tr> <tr> <td>8</td> <td>品受</td> </tr> <tr> <td>9</td> <td>品渡</td> </tr> </tbody> </table>
Side string `json:"Side,omitempty"` // 規制売買<br> ※空売り規制の場合、「1:売」 <table> <thead> <tr> <th>定義値</th> <th>内容</th> </tr> </thead> <tbody> <tr> <td>0</td> <td>全対象</td> </tr> <tr> <td>1</td> <td>売</td> </tr> <tr> <td>2</td> <td>買</td> </tr> </tbody> </table>
Reason string `json:"Reason,omitempty"` // 理由<br>※空売り規制の場合、「空売り規制」
LimitStartDay string `json:"LimitStartDay,omitempty"` // 制限開始日<br>yyyy/MM/dd HH:mm形式 <br>※空売り規制の場合、null
LimitEndDay string `json:"LimitEndDay,omitempty"` // 制限終了日<br>yyyy/MM/dd HH:mm形式 <br>※空売り規制の場合、null
Level int `json:"Level,omitempty"` // コンプライアンスレベル<br> ※空売り規制の場合、null <table> <thead> <tr> <th>定義値</th> <th>内容</th> </tr> </thead> <tbody> <tr> <td>0</td> <td>規制無し</td> </tr> <tr> <td>1</td> <td>ワーニング</td> </tr> <tr> <td>2</td> <td>エラー</td> </tr> </tbody> </table>
} `json:"RegulationsInfo,omitempty"`
}
ResGetInfoRegulationsSymbol は **GET /regulations/{symbol}** のレスポンス。
規制情報
func GetInfoRegulationsSymbol ¶
func GetInfoRegulationsSymbol(req ReqGetInfoRegulationsSymbol) (code int, res ResGetInfoRegulationsSymbol, err error)
GetInfoRegulationsSymbol は **GET /regulations/{symbol}** を呼び出して規制情報を取得します。
機能:
- 指定した銘柄に適用される各種売買規制や空売り規制の情報を取得する。
引数:
- req (ReqGetInfoRegulationsSymbol): 銘柄コードと市場コードを含むパスパラメータ。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetInfoRegulationsSymbol): 取得した規制情報。
- err (error): 通信エラーまたは APIError。
type ResGetInfoSymbolSymbol ¶
type ResGetInfoSymbolSymbol struct {
// 銘柄コード
Symbol string `json:"Symbol,omitempty"`
// 銘柄名
SymbolName string `json:"SymbolName,omitempty"`
// 銘柄略称 ※株式・先物・オプション銘柄の場合のみ
DisplayName string `json:"DisplayName,omitempty"`
// 市場コード ※株式・先物・オプション銘柄の場合のみ 定義値 説明 1 東証 3 名証 5 福証 6 札証 2 日通し 23 日中 24 夜間
Exchange int `json:"Exchange,omitempty"`
// 市場名称 ※株式・先物・オプション銘柄の場合のみ
ExchangeName string `json:"ExchangeName,omitempty"`
// 業種コード名 ※株式銘柄の場合のみ 定義値 説明 0050 水産・農林業 1050 鉱業 2050 建設業 3050 食料品 3100 繊維製品 3150 パルプ・紙 3200 化学 3250 医薬品 3300 石油・石炭製品 3350 ゴム製品 3400 ガラス・土石製品 3450 鉄鋼 3500 非鉄金属 3550 金属製品 3600 機械 3650 電気機器 3700 輸送用機器 3750 精密機器 3800 その他製品 4050 電気・ガス業 5050 陸運業 5100 海運業 5150 空運業 5200 倉庫・運輸関連業 5250 情報・通信業 6050 卸売業 6100 小売業 7050 銀行業 7100 証券、商品先物取引業 7150 保険業 7200 その他金融業 8050 不動産業 9050 サービス業 9999 その他
BisCategory string `json:"BisCategory,omitempty"`
// 時価総額 ※株式銘柄の場合のみ 追加情報出力フラグ:falseの場合、null
TotalMarketValue float64 `json:"TotalMarketValue,omitempty"`
// 発行済み株式数(千株) ※株式銘柄の場合のみ 追加情報出力フラグ:falseの場合、null
TotalStocks float64 `json:"TotalStocks,omitempty"`
// 売買単位 ※株式・先物・オプション銘柄の場合のみ
TradingUnit float64 `json:"TradingUnit,omitempty"`
// 決算期日 ※株式銘柄の場合のみ 追加情報出力フラグ:falseの場合、null
FiscalYearEndBasic int `json:"FiscalYearEndBasic,omitempty"`
// 呼値グループ ※株式・先物・オプション銘柄の場合のみ ※各呼値コードが対応する商品は以下となります。 株式の呼値の単位の詳細は [JPXページ](https://www.jpx.co.jp/equities/trading/domestic/07.html) をご覧ください。 10000:株式(通常の呼値単位の銘柄) 10003:株式(TOPIX500構成銘柄※売買単位が10口以上のETF等含む) 10004:株式(売買単位が1口のETF等) 10118 : 日経平均先物 10119 : 日経225mini 10318 : 日経平均オプション 10706 : ミニTOPIX先物 10718 : TOPIX先物 12122 : JPX日経400指数先物 14473 : NYダウ先物 14515 : 日経平均VI先物 15411 : グロース250先物 15569 : 東証REIT指数先物 17163 : TOPIXCore30指数先物 呼値コード 値段の水準 呼値単位 10000 3000円以下 1 10000 5000円以下 5 10000 30000円以下 10 10000 50000円以下 50 10000 300000円以下 100 10000 500000円以下 500 10000 3000000円以下 1000 10000 5000000円以下 5000 10000 30000000円以下 10000 10000 50000000円以下 50000 10000 50000000円超 100000 10003 1000円以下 0.1 10003 3000円以下 0.5 10003 10000円以下 1 10003 30000円以下 5 10003 100000円以下 10 10003 300000円以下 50 10003 1000000円以下 100 10003 3000000円以下 500 10003 10000000円以下 1000 10003 30000000円以下 5000 10003 30000000円超 10000 10004 10000円以下 1 10004 30000円以下 5 10004 100000円以下 10 10004 300000円以下 50 10004 1000000円以下 100 10004 3000000円以下 500 10004 10000000円以下 1000 10004 30000000円以下 5000 10004 30000000円超 10000 10118 - 10 10119 - 5 10318 100円以下 1 10318 1000円以下 5 10318 1000円超 10 10706 - 0.25 10718 - 0.5 12122 - 5 14473 - 1 14515 - 0.05 15411 - 1 15569 - 0.5 17163 - 0.5
PriceRangeGroup string `json:"PriceRangeGroup,omitempty"`
// 一般信用買建フラグ ※trueのとき、一般信用(長期)または一般信用(デイトレ)が買建可能 ※株式銘柄の場合のみ
KCMarginBuy bool `json:"KCMarginBuy,omitempty"`
// 一般信用売建フラグ ※trueのとき、一般信用(長期)または一般信用(デイトレ)が売建可能 ※株式銘柄の場合のみ
KCMarginSell bool `json:"KCMarginSell,omitempty"`
// 制度信用買建フラグ ※trueのとき制度信用買建可能 ※株式銘柄の場合のみ
MarginBuy bool `json:"MarginBuy,omitempty"`
// 制度信用売建フラグ ※trueのとき制度信用売建可能 ※株式銘柄の場合のみ
MarginSell bool `json:"MarginSell,omitempty"`
// 値幅上限 ※株式・先物・オプション銘柄の場合のみ
UpperLimit float64 `json:"UpperLimit,omitempty"`
// 値幅下限 ※株式・先物・オプション銘柄の場合のみ
LowerLimit float64 `json:"LowerLimit,omitempty"`
// 原資産コード ※先物・オプション銘柄の場合のみ 定義値 説明 NK225 日経225 NK300 日経300 GROWTH グロース250先物 JPX400 JPX日経400 TOPIX TOPIX NKVI 日経平均VI DJIA NYダウ TSEREITINDEX 東証REIT指数 TOPIXCORE30 TOPIX Core30
Underlyer string `json:"Underlyer,omitempty"`
// 限月-年月 ※「限月-年月」は「年(yyyy)/月(MM)」で表示します。 ※先物・オプション銘柄の場合のみ
DerivMonth string `json:"DerivMonth,omitempty"`
// 取引開始日 ※先物・オプション銘柄の場合のみ
TradeStart int `json:"TradeStart,omitempty"`
// 取引終了日 ※先物・オプション銘柄の場合のみ
TradeEnd int `json:"TradeEnd,omitempty"`
// 権利行使価格 ※オプション銘柄の場合のみ
StrikePrice float64 `json:"StrikePrice,omitempty"`
// プット/コール区分 ※オプション銘柄の場合のみ 定義値 説明 1 プット 2 コール
PutOrCall int `json:"PutOrCall,omitempty"`
// 清算値 ※先物銘柄の場合のみ 追加情報出力フラグ:falseの場合、null
ClearingPrice float64 `json:"ClearingPrice,omitempty"`
}
ResGetInfoSymbolSymbol は **GET /symbol/{symbol}** のレスポンス。
銘柄情報
func GetInfoSymbolSymbol ¶
func GetInfoSymbolSymbol(req ReqGetInfoSymbolSymbol) (code int, res ResGetInfoSymbolSymbol, err error)
GetInfoSymbolSymbol は **GET /symbol/{symbol}** を呼び出して銘柄情報を取得します。
機能:
- 指定した銘柄の基本属性(銘柄種別、権利情報、価格情報など)を取得する。
引数:
- req (ReqGetInfoSymbolSymbol): 銘柄コードと市場コードを含むパスパラメータ。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetInfoSymbolSymbol): 取得した銘柄情報。
- err (error): 通信エラーまたは APIError。
type ResGetInfoSymbolnameFuture ¶
type ResGetInfoSymbolnameFuture struct {
// 銘柄コード
Symbol string `json:"Symbol,omitempty"`
// 銘柄名称
SymbolName string `json:"SymbolName,omitempty"`
}
ResGetInfoSymbolnameFuture は **GET /symbolname/future** のレスポンス。
先物銘柄コード取得
func GetInfoSymbolnameFuture ¶
func GetInfoSymbolnameFuture(req ReqGetInfoSymbolnameFuture) (code int, res ResGetInfoSymbolnameFuture, err error)
GetInfoSymbolnameFuture は **GET /symbolname/future** を呼び出して先物銘柄コードを取得します。
機能:
- 先物銘柄コード区分や限月指定に基づき、取引可能な先物銘柄コード一覧を取得する。
引数:
- req (ReqGetInfoSymbolnameFuture): 先物コード区分や限月、取引日を指定するリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetInfoSymbolnameFuture): 取得した先物銘柄コード情報。
- err (error): 通信エラーまたは APIError。
type ResGetInfoSymbolnameMinioptionweekly ¶
type ResGetInfoSymbolnameMinioptionweekly struct {
// 銘柄コード
Symbol string `json:"Symbol,omitempty"`
// 銘柄名称
SymbolName string `json:"SymbolName,omitempty"`
}
ResGetInfoSymbolnameMinioptionweekly は **GET /symbolname/minioptionweekly** のレスポンス。
ミニオプション(限週)銘柄コード取得
func GetInfoSymbolnameMinioptionweekly ¶
func GetInfoSymbolnameMinioptionweekly(req ReqGetInfoSymbolnameMinioptionweekly) (code int, res ResGetInfoSymbolnameMinioptionweekly, err error)
GetInfoSymbolnameMinioptionweekly は **GET /symbolname/minioptionweekly** を呼び出してミニオプション(限週)の銘柄コードを取得します。
機能:
- ミニオプションの限月・限週条件を指定し、取引可能な銘柄コード一覧を取得する。
引数:
- req (ReqGetInfoSymbolnameMinioptionweekly): 限月や限週を指定するリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetInfoSymbolnameMinioptionweekly): 取得したミニオプション銘柄コード情報。
- err (error): 通信エラーまたは APIError。
type ResGetInfoSymbolnameOption ¶
type ResGetInfoSymbolnameOption struct {
// 銘柄コード
Symbol string `json:"Symbol,omitempty"`
// 銘柄名称
SymbolName string `json:"SymbolName,omitempty"`
}
ResGetInfoSymbolnameOption は **GET /symbolname/option** のレスポンス。
オプション銘柄コード取得
func GetInfoSymbolnameOption ¶
func GetInfoSymbolnameOption(req ReqGetInfoSymbolnameOption) (code int, res ResGetInfoSymbolnameOption, err error)
GetInfoSymbolnameOption は **GET /symbolname/option** を呼び出してオプション銘柄コードを取得します。
機能:
- オプション銘柄コード区分や限月、権利行使価格などの条件に基づき、取引可能なオプション銘柄コード一覧を取得する。
引数:
- req (ReqGetInfoSymbolnameOption): オプションコード区分や限月指定などの取得条件。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetInfoSymbolnameOption): 取得したオプション銘柄コード情報。
- err (error): 通信エラーまたは APIError。
type ResGetWalletWalletCash ¶
type ResGetWalletWalletCash struct {
// 現物買付可能額<br>※auマネーコネクトが有効の場合、auじぶん銀行の残高を含めた合計可能額を表示する<br>※auマネーコネクトが無効の場合、三菱UFJ eスマート証券の可能額のみを表示する
StockAccountWallet float64 `json:"StockAccountWallet,omitempty"`
// うち、三菱UFJ eスマート証券可能額
AuKCStockAccountWallet float64 `json:"AuKCStockAccountWallet,omitempty"`
// うち、auじぶん銀行残高<br>※auマネーコネクトが無効の場合、「0」を表示する
AuJbnStockAccountWallet float64 `json:"AuJbnStockAccountWallet,omitempty"`
}
ResGetWalletWalletCash は **GET /wallet/cash** のレスポンス。
### 概要 取引余力(現物)
func GetWalletWalletCash ¶
func GetWalletWalletCash(req ReqGetWalletWalletCash) (code int, res ResGetWalletWalletCash, err error)
GetWalletWalletCash は **GET /wallet/cash** を呼び出して現物の取引余力を取得します。
機能:
- 現物取引用の買付可能額を取得する。
引数:
- req (ReqGetWalletWalletCash): 空のリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetWalletWalletCash): 現物取引余力の情報。
- err (error): 通信エラーまたは APIError。
type ResGetWalletWalletCashSymbol ¶
type ResGetWalletWalletCashSymbol struct {
// 現物買付可能額<br>※auマネーコネクトが有効の場合、auじぶん銀行の残高を含めた合計可能額を表示する<br>※auマネーコネクトが無効の場合、三菱UFJ eスマート証券の可能額のみを表示する
StockAccountWallet float64 `json:"StockAccountWallet,omitempty"`
// うち、三菱UFJ eスマート証券可能額
AuKCStockAccountWallet float64 `json:"AuKCStockAccountWallet,omitempty"`
// うち、auじぶん銀行残高<br>※auマネーコネクトが無効の場合、「0」を表示する
AuJbnStockAccountWallet float64 `json:"AuJbnStockAccountWallet,omitempty"`
}
ResGetWalletWalletCashSymbol は **GET /wallet/cash/{symbol}** のレスポンス。
### 概要 取引余力(現物)(銘柄指定)
func GetWalletWalletCashSymbol ¶
func GetWalletWalletCashSymbol(req ReqGetWalletWalletCashSymbol) (code int, res ResGetWalletWalletCashSymbol, err error)
GetWalletWalletCashSymbol は **GET /wallet/cash/{symbol}** を呼び出して銘柄別の現物取引余力を取得します。
機能:
- 指定した銘柄コードに対する現物買付可能額を取得する。
引数:
- req (ReqGetWalletWalletCashSymbol): 銘柄コードと市場コードを含むリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetWalletWalletCashSymbol): 銘柄別の現物取引余力。
- err (error): 通信エラーまたは APIError。
type ResGetWalletWalletFuture ¶
type ResGetWalletWalletFuture struct {
// 新規建玉可能額
FutureTradeLimit float64 `json:"FutureTradeLimit,omitempty"`
// 買い必要証拠金額<br>※銘柄指定の場合のみ。<br>※銘柄が指定されなかった場合、空を返す。
MarginRequirement float64 `json:"MarginRequirement,omitempty"`
// 売り必要証拠金額<br>※銘柄指定の場合のみ。<br>※銘柄が指定されなかった場合、空を返す。
MarginRequirementSell float64 `json:"MarginRequirementSell,omitempty"`
}
ResGetWalletWalletFuture は **GET /wallet/future** のレスポンス。
### 概要 取引余力(先物)
func GetWalletWalletFuture ¶
func GetWalletWalletFuture(req ReqGetWalletWalletFuture) (code int, res ResGetWalletWalletFuture, err error)
GetWalletWalletFuture は **GET /wallet/future** を呼び出して先物取引の余力を取得します。
機能:
- 先物口座の建玉評価額や拘束証拠金などを取得する。
引数:
- req (ReqGetWalletWalletFuture): 空のリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetWalletWalletFuture): 先物取引余力の情報。
- err (error): 通信エラーまたは APIError。
type ResGetWalletWalletFutureSymbol ¶
type ResGetWalletWalletFutureSymbol struct {
// 新規建玉可能額
FutureTradeLimit float64 `json:"FutureTradeLimit,omitempty"`
// 買い必要証拠金額<br>※銘柄指定の場合のみ。<br>※銘柄が指定されなかった場合、空を返す。
MarginRequirement float64 `json:"MarginRequirement,omitempty"`
// 売り必要証拠金額<br>※銘柄指定の場合のみ。<br>※銘柄が指定されなかった場合、空を返す。
MarginRequirementSell float64 `json:"MarginRequirementSell,omitempty"`
}
ResGetWalletWalletFutureSymbol は **GET /wallet/future/{symbol}** のレスポンス。
### 概要 取引余力(先物)(銘柄指定)
func GetWalletWalletFutureSymbol ¶
func GetWalletWalletFutureSymbol(req ReqGetWalletWalletFutureSymbol) (code int, res ResGetWalletWalletFutureSymbol, err error)
GetWalletWalletFutureSymbol は **GET /wallet/future/{symbol}** を呼び出して銘柄別の先物取引余力を取得します。
機能:
- 指定した先物銘柄に対する必要証拠金や評価額を取得する。
引数:
- req (ReqGetWalletWalletFutureSymbol): 銘柄コードと市場コードを含むリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetWalletWalletFutureSymbol): 銘柄別の先物取引余力。
- err (error): 通信エラーまたは APIError。
type ResGetWalletWalletMargin ¶
type ResGetWalletWalletMargin struct {
// 信用新規可能額
MarginAccountWallet float64 `json:"MarginAccountWallet,omitempty"`
// 保証金維持率<br>※銘柄指定の場合のみ<br>※銘柄が指定されなかった場合、0.0を返す。
DepositkeepRate float64 `json:"DepositkeepRate,omitempty"`
// 委託保証金率<br>※銘柄指定の場合のみ。<br>※銘柄が指定されなかった場合、Noneを返す。
ConsignmentDepositRate float64 `json:"ConsignmentDepositRate,omitempty"`
// 現金委託保証金率<br>※銘柄指定の場合のみ。<br>※銘柄が指定されなかった場合、Noneを返す。
CashOfConsignmentDepositRate float64 `json:"CashOfConsignmentDepositRate,omitempty"`
}
ResGetWalletWalletMargin は **GET /wallet/margin** のレスポンス。
### 概要 取引余力(信用)
func GetWalletWalletMargin ¶
func GetWalletWalletMargin(req ReqGetWalletWalletMargin) (code int, res ResGetWalletWalletMargin, err error)
GetWalletWalletMargin は **GET /wallet/margin** を呼び出して信用取引余力を取得します。
機能:
- 信用新規可能額や保証金率など、信用取引に関する口座余力を取得する。
引数:
- req (ReqGetWalletWalletMargin): 空のリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetWalletWalletMargin): 信用取引余力の情報。
- err (error): 通信エラーまたは APIError。
type ResGetWalletWalletMarginSymbol ¶
type ResGetWalletWalletMarginSymbol struct {
// 信用新規可能額
MarginAccountWallet float64 `json:"MarginAccountWallet,omitempty"`
// 保証金維持率<br>※銘柄指定の場合のみ<br>※銘柄が指定されなかった場合、0.0を返す。
DepositkeepRate float64 `json:"DepositkeepRate,omitempty"`
// 委託保証金率<br>※銘柄指定の場合のみ。<br>※銘柄が指定されなかった場合、Noneを返す。
ConsignmentDepositRate float64 `json:"ConsignmentDepositRate,omitempty"`
// 現金委託保証金率<br>※銘柄指定の場合のみ。<br>※銘柄が指定されなかった場合、Noneを返す。
CashOfConsignmentDepositRate float64 `json:"CashOfConsignmentDepositRate,omitempty"`
}
ResGetWalletWalletMarginSymbol は **GET /wallet/margin/{symbol}** のレスポンス。
### 概要 取引余力(信用)(銘柄指定)
func GetWalletWalletMarginSymbol ¶
func GetWalletWalletMarginSymbol(req ReqGetWalletWalletMarginSymbol) (code int, res ResGetWalletWalletMarginSymbol, err error)
GetWalletWalletMarginSymbol は **GET /wallet/margin/{symbol}** を呼び出して銘柄別の信用取引余力を取得します。
機能:
- 指定した銘柄の保証金率や信用新規可能額などを取得する。
引数:
- req (ReqGetWalletWalletMarginSymbol): 銘柄コードと市場コードを含むリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetWalletWalletMarginSymbol): 銘柄別の信用取引余力。
- err (error): 通信エラーまたは APIError。
type ResGetWalletWalletOption ¶
type ResGetWalletWalletOption struct {
// 買新規建玉可能額
OptionBuyTradeLimit float64 `json:"OptionBuyTradeLimit,omitempty"`
// 売新規建玉可能額
OptionSellTradeLimit float64 `json:"OptionSellTradeLimit,omitempty"`
// 必要証拠金額<br>※銘柄指定の場合のみ。<br>※銘柄が指定されなかった場合、空を返す。
MarginRequirement float64 `json:"MarginRequirement,omitempty"`
}
ResGetWalletWalletOption は **GET /wallet/option** のレスポンス。
### 概要 取引余力(オプション)
func GetWalletWalletOption ¶
func GetWalletWalletOption(req ReqGetWalletWalletOption) (code int, res ResGetWalletWalletOption, err error)
GetWalletWalletOption は **GET /wallet/option** を呼び出してオプション取引余力を取得します。
機能:
- オプション取引における買建・売建可能額や必要証拠金を取得する。
引数:
- req (ReqGetWalletWalletOption): 空のリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetWalletWalletOption): オプション取引余力の情報。
- err (error): 通信エラーまたは APIError。
type ResGetWalletWalletOptionSymbol ¶
type ResGetWalletWalletOptionSymbol struct {
// 買新規建玉可能額
OptionBuyTradeLimit float64 `json:"OptionBuyTradeLimit,omitempty"`
// 売新規建玉可能額
OptionSellTradeLimit float64 `json:"OptionSellTradeLimit,omitempty"`
// 必要証拠金額<br>※銘柄指定の場合のみ。<br>※銘柄が指定されなかった場合、空を返す。
MarginRequirement float64 `json:"MarginRequirement,omitempty"`
}
ResGetWalletWalletOptionSymbol は **GET /wallet/option/{symbol}** のレスポンス。
### 概要 取引余力(オプション)(銘柄指定)
func GetWalletWalletOptionSymbol ¶
func GetWalletWalletOptionSymbol(req ReqGetWalletWalletOptionSymbol) (code int, res ResGetWalletWalletOptionSymbol, err error)
GetWalletWalletOptionSymbol は **GET /wallet/option/{symbol}** を呼び出して銘柄別のオプション取引余力を取得します。
機能:
- 指定したオプション銘柄の建玉可能額や必要証拠金を取得する。
引数:
- req (ReqGetWalletWalletOptionSymbol): 銘柄コードと市場コードを含むリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResGetWalletWalletOptionSymbol): 銘柄別のオプション取引余力。
- err (error): 通信エラーまたは APIError。
type ResPostAuthToken ¶
type ResPostAuthToken struct {
// 結果コード<br>0が成功。それ以外はエラーコード。
ResultCode int `json:"ResultCode,omitempty"`
// APIトークン
Token string `json:"Token,omitempty"`
}
ResPostAuthToken は **POST /token** のレスポンス。
### 概要 トークン発行
func PostAuthToken ¶
func PostAuthToken(req ReqPostAuthToken) (code int, res ResPostAuthToken, err error)
PostAuthToken は **POST /token** を実行し、API トークンを発行します。
機能:
- kabuステーション API のトークン発行エンドポイントへリクエストを送り、新規トークンを取得する。
引数:
- req (ReqPostAuthToken): API パスワードを含むリクエストボディ。
返り値:
- code (int): HTTP ステータスコード。
- res (ResPostAuthToken): 発行結果コードと取得したトークン。
- err (error): 通信エラーまたは APIError。
type ResPostOrderSendorder ¶
type ResPostOrderSendorder struct {
// 結果コード<br>0が成功。それ以外はエラーコード。
Result int `json:"Result,omitempty"`
// 受付注文番号
OrderId string `json:"OrderId,omitempty"`
}
ResPostOrderSendorder は **POST /sendorder** のレスポンス。
### 概要 注文発注(現物・信用)
func PostOrderSendorder ¶
func PostOrderSendorder(req ReqPostOrderSendorder) (code int, res ResPostOrderSendorder, err error)
PostOrderSendorder は **POST /sendorder** を実行し、現物・信用の注文を発注します。
機能:
- 銘柄コード、売買区分、数量、価格、執行条件などを指定して株式(現物/信用)の新規・返済注文を送信する。
引数:
- req (ReqPostOrderSendorder): 発注内容をまとめたリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResPostOrderSendorder): 受付結果と注文番号。
- err (error): 通信エラーまたは APIError。
type ResPostOrderSendorderFuture ¶
type ResPostOrderSendorderFuture struct {
// 結果コード<br>0が成功。それ以外はエラーコード。
Result int `json:"Result,omitempty"`
// 受付注文番号
OrderId string `json:"OrderId,omitempty"`
}
ResPostOrderSendorderFuture は **POST /sendorder/future** のレスポンス。
### 概要 注文発注(先物)
func PostOrderSendorderFuture ¶
func PostOrderSendorderFuture(req ReqPostOrderSendorderFuture) (code int, res ResPostOrderSendorderFuture, err error)
PostOrderSendorderFuture は **POST /sendorder/future** を実行し、先物の注文を発注します。
機能:
- 取引区分や数量、執行条件などを指定し、先物取引の新規・返済注文を送信する。
引数:
- req (ReqPostOrderSendorderFuture): 先物注文の内容をまとめたリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResPostOrderSendorderFuture): 受付結果と注文番号。
- err (error): 通信エラーまたは APIError。
type ResPostOrderSendorderOption ¶
type ResPostOrderSendorderOption struct {
// 結果コード<br>0が成功。それ以外はエラーコード。
Result int `json:"Result,omitempty"`
// 受付注文番号
OrderId string `json:"OrderId,omitempty"`
}
ResPostOrderSendorderOption は **POST /sendorder/option** のレスポンス。
### 概要 注文発注(オプション)
func PostOrderSendorderOption ¶
func PostOrderSendorderOption(req ReqPostOrderSendorderOption) (code int, res ResPostOrderSendorderOption, err error)
PostOrderSendorderOption は **POST /sendorder/option** を実行し、オプションの注文を発注します。
機能:
- 売買区分や建玉指定、価格、執行条件などを指定し、オプション取引の新規・返済注文を送信する。
引数:
- req (ReqPostOrderSendorderOption): オプション注文の内容をまとめたリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResPostOrderSendorderOption): 受付結果と注文番号。
- err (error): 通信エラーまたは APIError。
type ResPutOrderCancelorder ¶
type ResPutOrderCancelorder struct {
// 結果コード<br>0が成功。それ以外はエラーコード。
Result int `json:"Result,omitempty"`
// 受付注文番号
OrderId string `json:"OrderId,omitempty"`
}
ResPutOrderCancelorder は **PUT /cancelorder** のレスポンス。
### 概要 注文取消
func PutOrderCancelorder ¶
func PutOrderCancelorder(req ReqPutOrderCancelorder) (code int, res ResPutOrderCancelorder, err error)
PutOrderCancelorder は **PUT /cancelorder** を実行し、既存注文を取り消します。
機能:
- 受付済みの注文番号を指定して、発注済みの注文をキャンセルする。
引数:
- req (ReqPutOrderCancelorder): 取消対象の OrderId を含むリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResPutOrderCancelorder): 取消結果と注文番号。
- err (error): 通信エラーまたは APIError。
type ResPutRegisterRegister ¶
type ResPutRegisterRegister struct {
// 現在登録されている銘柄のリスト
RegistList []struct {
Symbol string `json:"Symbol,omitempty"` // 銘柄コード
// Exchange は市場コード。
// - 1: 東証
// - 3: 名証
// - 5: 福証
// - 6: 札証
// - 2: 日通し
// - 23: 日中
// - 24: 夜間
Exchange int `json:"Exchange,omitempty"`
} `json:"RegistList,omitempty"`
}
ResPutRegisterRegister は PUT /register のレスポンス。
- 返却内容: 登録済み銘柄リスト
func PutRegisterRegister ¶
func PutRegisterRegister(req ReqPutRegisterRegister) (code int, res ResPutRegisterRegister, err error)
PutRegisterRegister は **PUT /register** を実行し、PUSH 配信対象の銘柄を登録します。
機能:
- PUSH 配信で受信したい銘柄と市場コードのリストを API 登録銘柄リストに追加する。
引数:
- req (ReqPutRegisterRegister): 登録する銘柄コードと市場コードの配列。
返り値:
- code (int): HTTP ステータスコード。
- res (ResPutRegisterRegister): 登録後の銘柄リスト。
- err (error): 通信エラーまたは APIError。
type ResPutRegisterUnregister ¶
type ResPutRegisterUnregister struct {
// 現在登録されている銘柄のリスト
RegistList []struct {
Symbol string `json:"Symbol,omitempty"` // 銘柄コード
// Exchange は市場コード。
// - 1: 東証
// - 3: 名証
// - 5: 福証
// - 6: 札証
// - 2: 日通し
// - 23: 日中
// - 24: 夜間
// - 300: 為替(通貨ペア)
Exchange int `json:"Exchange,omitempty"`
} `json:"RegistList,omitempty"`
}
ResPutRegisterUnregister は PUT /unregister のレスポンス。
- 返却内容: 登録解除後の銘柄リスト
func PutRegisterUnregister ¶
func PutRegisterUnregister(req ReqPutRegisterUnregister) (code int, res ResPutRegisterUnregister, err error)
PutRegisterUnregister は **PUT /unregister** を実行し、指定銘柄の PUSH 登録を解除します。
機能:
- API 登録銘柄リストに登録済みの銘柄を指定し、PUSH 配信対象から削除する。
引数:
- req (ReqPutRegisterUnregister): 解除対象の銘柄コードと市場コードのリスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResPutRegisterUnregister): 解除後の登録銘柄リスト。
- err (error): 通信エラーまたは APIError。
type ResPutRegisterUnregisterAll ¶
type ResPutRegisterUnregisterAll struct {
// 現在登録されている銘柄のリスト。
// - 全解除が成功した場合は空。
// - エラーがある場合は解除前の登録銘柄を返す。
RegistList []interface{}
}
ResPutRegisterUnregisterAll は PUT /unregister/all のレスポンス。
- 返却内容: 全解除後の登録銘柄リスト
func PutRegisterUnregisterAll ¶
func PutRegisterUnregisterAll(req ReqPutRegisterUnregisterAll) (code int, res ResPutRegisterUnregisterAll, err error)
PutRegisterUnregisterAll は **PUT /unregister/all** を実行し、登録銘柄を一括解除します。
機能:
- API 登録銘柄リストに登録されている全銘柄を PUSH 配信対象からまとめて削除する。
引数:
- req (ReqPutRegisterUnregisterAll): 全解除を指示する空のリクエスト。
返り値:
- code (int): HTTP ステータスコード。
- res (ResPutRegisterUnregisterAll): 解除後の登録銘柄リスト。
- err (error): 通信エラーまたは APIError。