IPO Calendar API ドキュメント

2023年11月からすべてのAPI呼び出しに、認証キーが必要になります。

IPO Calendar API は、株式市場の新規上場スケジュールを確認できるシンプルな RESTful API です。
東証一部・二部、マザーズ、JASDAQの銘柄に対応しています。

パブリックAPI ¶

IPO Calendar APIは以下の共通フォーマットをレスポンスします。

属性名	型	概要
result	boolean	APIの成否に応じて `true` または `false`
code	number	ステータスコード
detail	string	ステータスメッセージ
data	object or object[]	データを返すAPIの場合、配列またはオブジェクト

{
    "result": true,
    "code": 200,
    "detail": "OK",
    "data": {}
}

APIで取得できるIPOオブジェクトは次の属性を持ちます。

属性名	型	概要
_id	string	ID
code	string	銘柄コード
date	string	上場日
name	string	会社名
market_key	string	市場区分
market_name	string	市場名
sector_key	string	業種区分
sector_name	string	業種名
url	string	会社ホームページ
p_kari	string	仮条件（円）
v_kobo	string	公募（千株）
p_uri	string	公募・売出価格（円）
v_uri	string	売出（千株）
unit	string	売買単位
fs_ol	string[]	会社概要（上場前公表時点） URL
fs_i	string[]	Iの部 URL
fs_k	string[]	確認書 URL
fs_cg	string[]	CG報告書 URL
fs_tan	string[]	決算短信 URL

{
    "_id": "3930",
    "code": "3930",
    "date": "2016/02/24",
    "name": "（株）はてな",
    "market_key": "mothers",
    "market_name": "マザーズ",
    "sector_key": "ifc",
    "sector_name": "情報・通信",
    "url": "http://hatenacorp.jp/",
    "p_kari": "700～800",
    "v_kobo": "370",
    "p_uri": "800",
    "v_uri": "385(OA113.2)",
    "unit": "100",
    "fs_ol": [
        "http://www.jpx.co.jp/listing/stocks/new/nlsgeu000001em70-att/02Hatena-Outline.pdf"
    ],
    "fs_i": [
        "http://www.jpx.co.jp/listing/stocks/new/nlsgeu000001em70-att/02Hatena-1s.pdf"
    ],
    "fs_k": [
        "http://www.jpx.co.jp/listing/stocks/new/nlsgeu000001em70-att/02Hatena-k.pdf"
    ],
    "fs_cg": [
        "http://www.jpx.co.jp/listing/stocks/new/nlsgeu000001em70-att/02Hatena-cg.pdf"
    ],
    "fs_tan": [
        "http://www.jpx.co.jp/listing/stocks/new/nlsgeu000001em70-att/02Hatena.pdf"
    ]
}

コレクション取得時は一部の情報を省略したIPOサマリーオブジェクトを返します。

属性名	型	概要
_id	string	ID
code	string	銘柄コード
date	string	上場日
name	string	会社名
market_key	string	市場区分
market_name	string	市場名
sector_key	string	業種区分
sector_name	string	業種名
url	string	会社ホームページ
p_kari	string	仮条件（円）
v_kobo	string	公募（千株）
p_uri	string	公募・売出価格（円）
v_uri	string	売出（千株）
unit	string	売買単位

[{
    "_id": "7185",
    "code": "7185",
    "date": "2016/03/18",
    "name": "ヒロセ通商（株）",
    "market_key": "jasdaqst",
    "market_name": "JQスタンダード",
    "sector_key": "ifc",
    "sector_name": "情報・通信",
    "url": "http://hirose-fx.co.jp/",
    "p_kari": "800～830",
    "v_kobo": "570",
    "p_uri": null,
    "v_uri": "530(OA165)",
    "unit": "100"
}]

IPOオブジェクト取得 ¶

GET`/api/ipo/{id}`

銘柄コードを指定して、以下の属性を持つIPOオブジェクトを取得します。

Example URI

GET http://ipo-cal.appspot.com/api/ipo/3930

URI Parameters

HideShow

id: string (required) Example: 3930
４桁の銘柄コード

Response 200

HideShow

Headers

Content-Type: application/json

Body

{
  "result": true,
  "code": 200,
  "detail": "OK",
  "data": {
    "_id": "3930",
    "code": "3930",
    "date": "2016/02/24",
    "name": "（株）はてな",
    "market_key": "mothers",
    "market_name": "マザーズ",
    "sector_key": "ifc",
    "sector_name": "情報・通信",
    "url": "http://hatenacorp.jp/",
    "p_kari": "700～800",
    "v_kobo": "370",
    "p_uri": "800",
    "v_uri": "385(OA113.2)",
    "unit": "100",
    "fs_ol": [
      "http://www.jpx.co.jp/listing/stocks/new/nlsgeu000001em70-att/02Hatena-Outline.pdf"
    ],
    "fs_i": [
      "http://www.jpx.co.jp/listing/stocks/new/nlsgeu000001em70-att/02Hatena-1s.pdf"
    ],
    "fs_k": [
      "http://www.jpx.co.jp/listing/stocks/new/nlsgeu000001em70-att/02Hatena-k.pdf"
    ],
    "fs_cg": [
      "http://www.jpx.co.jp/listing/stocks/new/nlsgeu000001em70-att/02Hatena-cg.pdf"
    ],
    "fs_tan": [
      "http://www.jpx.co.jp/listing/stocks/new/nlsgeu000001em70-att/02Hatena.pdf"
    ]
  }
}

Response 404

HideShow

Headers

Content-Type: application/json

Body

{
  "result": false,
  "code": 404,
  "detail": "Not Found"
}

IPOサマリーオブジェクト一覧取得 ¶

GET`/api/ipo{?page}`

上場予定日が新しい順に最大50件のIPOオブジェクトのサマリーを取得します。

Example URI

GET http://ipo-cal.appspot.com/api/ipo?page=0

URI Parameters

HideShow

page: number (optional) Example: 0
0から始まるページ番号

Response 200

HideShow

Headers

Content-Type: application/json

Body

{
  "result": true,
  "code": 200,
  "detail": "OK",
  "data": [
    {
      "_id": "7185",
      "code": "7185",
      "date": "2016/03/18",
      "name": "ヒロセ通商（株）",
      "market_key": "jasdaqst",
      "market_name": "JQスタンダード",
      "sector_key": "ifc",
      "sector_name": "情報・通信",
      "url": "http://hirose-fx.co.jp/",
      "p_kari": "800～830",
      "v_kobo": "570",
      "p_uri": null,
      "v_uri": "530(OA165)",
      "unit": "100"
    }
  ]
}

本日上場IPO取得 ¶

GET`/api/ipo/today`

本日上場のIPOオブジェクトサマリーを取得します。（日本時間: JST）

Example URI

GET http://ipo-cal.appspot.com/api/ipo/today

Response 200

HideShow

Headers

Content-Type: application/json

Body

{
  "result": true,
  "code": 200,
  "detail": "OK",
  "data": [
    {
      "_id": "7185",
      "code": "7185",
      "date": "2016/03/18",
      "name": "ヒロセ通商（株）",
      "market_key": "jasdaqst",
      "market_name": "JQスタンダード",
      "sector_key": "ifc",
      "sector_name": "情報・通信",
      "url": "http://hirose-fx.co.jp/",
      "p_kari": "800～830",
      "v_kobo": "570",
      "p_uri": null,
      "v_uri": "530(OA165)",
      "unit": "100"
    }
  ]
}

昨日上場IPO取得 ¶

GET`/api/ipo/yesterday`

昨日上場のIPOオブジェクトサマリーを取得します。（日本時間: JST）

Example URI

GET http://ipo-cal.appspot.com/api/ipo/yesterday

Response 200

HideShow

Headers

Content-Type: application/json

Body

{
  "result": true,
  "code": 200,
  "detail": "OK",
  "data": [
    {
      "_id": "7185",
      "code": "7185",
      "date": "2016/03/18",
      "name": "ヒロセ通商（株）",
      "market_key": "jasdaqst",
      "market_name": "JQスタンダード",
      "sector_key": "ifc",
      "sector_name": "情報・通信",
      "url": "http://hirose-fx.co.jp/",
      "p_kari": "800～830",
      "v_kobo": "570",
      "p_uri": null,
      "v_uri": "530(OA165)",
      "unit": "100"
    }
  ]
}

IPO Calendar API ドキュメント

パブリックAPI ¶

オブジェクト: 共通レスポンス

オブジェクト: IPO

オブジェクト: IPOサマリー

IPOオブジェクト取得 ¶

GET`/api/ipo/{id}`

Example URI

Headers

Body

Headers

Body

最新IPOオブジェクト取得 ¶

GET`/api/ipo/latest`

Example URI

Headers

Body

IPOサマリーオブジェクト一覧取得 ¶

GET`/api/ipo{?page}`

Example URI

Headers

Body

本日上場IPO取得 ¶

GET`/api/ipo/today`

Example URI

Headers

Body

昨日上場IPO取得 ¶

GET`/api/ipo/yesterday`

Example URI

Headers

Body

パブリックAPI ¶

オブジェクト: 共通レスポンス ¶

オブジェクト: IPO ¶

オブジェクト: IPOサマリー ¶

IPOオブジェクト取得 ¶

GET/api/ipo/{id}

Example URI

Headers

Body

Headers

Body

最新IPOオブジェクト取得 ¶

GET/api/ipo/latest

Example URI

Headers

Body

IPOサマリーオブジェクト一覧取得 ¶

GET/api/ipo{?page}

Example URI

Headers

Body

本日上場IPO取得 ¶

GET/api/ipo/today

Example URI

Headers

Body

昨日上場IPO取得 ¶

GET/api/ipo/yesterday

Example URI

Headers

Body

オブジェクト: 共通レスポンス

オブジェクト: IPO

オブジェクト: IPOサマリー

GET`/api/ipo/{id}`

GET`/api/ipo/latest`

GET`/api/ipo{?page}`

GET`/api/ipo/today`

GET`/api/ipo/yesterday`