Felo API PlatformFelo API Platform
Financial Data のエンドポイント一覧
v0.2.0-beta
OpenAPI 3.1.0

SEC 提出書類の項目を取得

サーバー:https://openapi.felo.ai
クライアントライブラリ

Financial Data

​

Company fundamentals, financial statements, market prices and economic data.

SEC 提出書類の項目を取得

​

1 件の SEC 提出書類内にある番号付き項目の全文です。ticker、filing_type(10-K、10-Q、8-K)、year はすべて必須です。quarter、item、accession_number、include_exhibits でさらに絞り込めます。items を返し、各項目には number、title、完全な text が含まれます。さらに filing_url と accession_number も返します。サイズに注意してください。10-K は約 19 項目の完全な文章として返るため、文書全体が本当に必要でない限り、すべてを取得するのではなく特定の item を要求してください。まずどの提出書類を開くかを調べるには get_financial_filings を使います。

料金の参考情報

  • 計量方式:成功リクエストあたりの固定コスト基準。
  • 参考リクエスト見積もり:USD 0.02。
  • 参照用の顧客乗数:1.0。確定済みの顧客金額には再適用しないでください。

参考情報のメタデータであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。

クエリパラメーター
  • accession_number
    型: string

    8-K の場合の提出書類の accession number。

  • filing_type
    型: string 列挙値
    必須

    提出書類の種類。

    値
    • 10-K
    • 10-Q
    • 8-K
  • include_exhibits
    型: boolean

    リンクされた添付書類から生テキストを含めるかどうか。8-K 提出書類にのみ適用されます。true の場合、添付オブジェクトには完全な添付内容を含む 'text' フィールドが追加されます。

  • item
    型: string 列挙値

    取得する項目。

    値
    • Item-1
    • Item-1A
    • Item-1B
    • Item-2
    • Item-3
  • quarter
    型: integer

    10-Q の場合の提出書類の四半期。

  • ticker
    型: string
    必須

    ティッカーシンボル。

  • year
    型: integer
    必須

    提出書類の年。

レスポンス
  • 200
    型: object · ResponseE40Feb4D3D6B_FilingItemsResponse

    SEC 提出書類の項目のレスポンス

    • accession_number
      型: string

      提出書類の accession number。

    • cik
      型: string

      企業の Central Index Key(CIK)。

    • filing_type
      型: string

      提出書類の種類。

    • items
      型: array object[] · ResponseE40Feb4D3D6B_FilingItem[]
      • exhibits
        型: array object[] · ResponseE40Feb4D3D6B_Exhibit[]

        この項目にリンクされた添付書類の配列。添付書類が存在する場合、8-K 提出書類にのみ含まれます。

        • description
          型: string

          添付書類の説明。

        • number
          型: string

          添付書類の番号(例:'99.1')。

        • text
          型: string

          添付書類の生テキスト。'include_exhibits' パラメーターが true に設定されている場合にのみ含まれます。

        • url
          型: string 形式: uri

          SEC ウェブサイト上の添付書類の URL。

      • name
        型: string

        項目の名前。

      • number
        型: string

        項目番号。

      • text
        型: string

        項目のテキスト。

    • quarter
      型: integer

      提出書類の四半期。

    • resource
      型: string

      リソースタイプの識別子。

    • ticker
      型: string

      会社の ticker シンボル。

    • year
      型: integer

      提出書類の年。

    application/json
  • 202
    型: object · ResponseE40Feb4D3D6B_FilingItemsAccepted

    提出書類はまだ準備中です。レスポンス本文の result_url をポーリングして結果を取得してください。このレスポンスには課金されません。

    • accession_number
      型: string

      準備中の提出書類の accession number。

    • estimated_ready_at
      型: string 形式: date-time

      提出書類が準備できる見込みの時期。

    • message
      型: string

      次に行うべきことの人間が読める説明。

    • request_id
      型: string 形式: uuid

      このリクエストの識別子。サポートに問い合わせる際に役立ちます。

    • result_url
      型: string

      結果をポーリングする URL。

    • status
      列挙値
      定数:  
      processing

      202 レスポンスでは常に 'processing' です。

      値
      • processing
    application/json
  • 400

    リクエストを処理できませんでした。リクエストパラメータを確認してください。

  • 401

    有効な Felo API キーが必要です。

  • 402

    請求要件が満たされていないため、リクエストを続行できません。

  • 403

    このアカウントにはこの操作を行う権限がありません。

  • 429

    リクエストまたは支出の上限に達しました。

  • 502

    サービスがリクエストを完了できませんでした。

  • 503

    API または請求サービスが一時的に利用できません。

  • 504

    リクエストの処理中にサービスがタイムアウトしました。

  • default

    エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります

    application/json
Request Example for get/v1/beta/financial/filings/items
curl 'https://openapi.felo.ai/v1/beta/financial/filings/items?filing_type=10-K&ticker=&year=1' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "resource": "string",
  "ticker": "string",
  "cik": "string",
  "filing_type": "string",
  "accession_number": "string",
  "year": 1,
  "quarter": 1,
  "items": [
    {
      "number": "string",
      "name": "string",
      "text": "string",
      "exhibits": [
        {
          "number": "string",
          "description": "string",
          "url": "https://example.com",
          "text": "string"
        }
      ]
    }
  ]
}
Get SEC filing items

ヘルプが必要ですか?

  • API・請求・アカウントのご質問はサポートへ。
  • Discord で Felo の開発者と交流できます。
  • 更新履歴 をご覧ください。
  • ボリューム価格や購買についてのご相談は営業窓口へ。
  • LLM での構築をお考えですか?llms.txt をご覧ください。