Yosou! / API Docs ログイン

📡 API Documentation

🎯 概要

Yosou! Public Trading API を使用すると、外部のBotやアプリケーションから予測市場の取引を行うことができます。

Base URL
https://www.ateko.jp/api.php

🔐 認証

取引系のAPIにはAPIキーによる認証が必要です。プロファイル設定でAPIキーを生成してください。

推奨: URLクエリパラメータ (確実)
?action=order&api_key=YOUR_API_KEY
リクエストヘッダー (サーバー環境により削除される場合があります)
Authorization: Bearer YOUR_API_KEY

📋 エンドポイント一覧

GET ?action=markets マーケット一覧(認証不要)
GET ?action=market&id=X マーケット詳細+板(認証不要)
GET ?action=orders 自分の注文一覧
POST ?action=order 注文発注
POST ?action=cancel 注文キャンセル
GET ?action=comments チャット履歴取得
POST ?action=comment チャット投稿
GET ?action=balance 残高確認
GET ?action=positions ポジション一覧

マーケット一覧取得

GET ?action=markets
認証不要

パラメータ

filter active, finished, all(デフォルト: active)

レスポンス例

{
  "success": true,
  "markets": [
    {
      "id": 1,
      "title": "ビットコインは2026年末までに$100,000を超えるか?",
      "current_price": 65.5,
      "current_phase": "active",
      "end_date": "2026-12-31 23:59:59"
    }
  ]
}

注文発注

POST ?action=order
認証必須

リクエストボディ (JSON)

{
  "market_id": 1,
  "side": "buy",      // "buy" or "sell"
  "type": "limit",    // "limit" (指値) or "market" (成行) - default: limit
  "price": 65.0,      // 指値の場合のみ必須 (0-100)
  "amount": 10        // 数量
}

レスポンス例

{
  "success": true,
  "order_id": 123,
  "message": "Order placed successfully"
}

注文キャンセル

POST ?action=cancel
認証必須

リクエストボディ (JSON)

{
  "order_id": 123
}

チャット投稿

POST ?action=comment
認証必須

リクエストボディ (JSON)

※ market_id=0 を指定すると「全体チャット (Global Chat)」への投稿になります。
{
  "market_id": 1,  // 0=Global Chat
  "message": "こんにちは"
}

⚠️ エラーレスポンス

{
  "success": false,
  "error": "Unauthorized. Please provide valid API key."
}

HTTPステータスコード: 400 (Bad Request), 401 (Unauthorized), 404 (Not Found), 500 (Server Error)

⏱️ レート制限

現在、レート制限は設定されていませんが、過度なリクエストはブロックされる可能性があります。 1秒あたり最大10リクエスト程度を推奨します。

Need help? Contact: yosouclub@gmail.com