Back to top
IPO Calendar

IPO Calendar API ドキュメント

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

>> Python版クライアント

パブリック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": {}
}

オブジェクト: IPO

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サマリー

コレクション取得時は一部の情報を省略した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

4桁の銘柄コード

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/latest

上場予定日が最も新しいIPOオブジェクトを取得します。

Example URI

GET http://ipo-cal.appspot.com/api/ipo/latest
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"
    ]
  }
}

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"
    }
  ]
}

 Generated by aglio  on 28 Mar 2016