Felo API PlatformFelo API Platform
সব Financial Data endpoint
v0.2.0-beta
OpenAPI 3.1.0

SEC ফাইলিং আইটেম নিন

সার্ভার:https://openapi.felo.ai
ক্লায়েন্ট লাইব্রেরি

Financial Data

​

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

Financial Data অপারেশন

SEC ফাইলিং আইটেম নিন

​

একটি 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 enum
    আবশ্যক

    ফাইলিংয়ের ধরন।

    মান
    • 10-K
    • 10-Q
    • 8-K
  • include_exhibits
    টাইপ: boolean

    সংযুক্ত exhibit থেকে raw টেক্সট অন্তর্ভুক্ত করবেন কি না। শুধু 8-K ফাইলিংয়ে প্রযোজ্য। true হলে, exhibit অবজেক্টে 'text' ফিল্ড থাকবে যাতে সম্পূর্ণ exhibit কনটেন্ট থাকবে।

  • item
    টাইপ: string enum

    যে item পেতে চান।

    মান
    • Item-1
    • Item-1A
    • Item-1B
    • Item-2
    • Item-3
  • quarter
    টাইপ: integer

    10-Q হলে ফাইলিংয়ের ত্রৈমাসিক।

  • ticker
    টাইপ: string
    আবশ্যক

    ticker চিহ্ন।

  • year
    টাইপ: integer
    আবশ্যক

    ফাইলিংয়ের বছর।

রেসপন্স
  • 200
    টাইপ: object · ResponseE40Feb4D3D6B_FilingItemsResponse

    SEC ফাইলিং আইটেম রেসপন্স

    • accession_number
      টাইপ: string

      ফাইলিংয়ের accession নম্বর

    • cik
      টাইপ: string

      কোম্পানির Central Index Key (CIK)।

    • filing_type
      টাইপ: string

      ফাইলিংয়ের ধরন।

    • items
      টাইপ: array object[] · ResponseE40Feb4D3D6B_FilingItem[]
      • exhibits
        টাইপ: array object[] · ResponseE40Feb4D3D6B_Exhibit[]

        এই আইটেমের সঙ্গে যুক্ত exhibit-গুলোর অ্যারে। শুধু 8-K ফাইলিংয়ে exhibit থাকলে উপস্থিত থাকে।

        • description
          টাইপ: string

          exhibit-এর বিবরণ

        • number
          টাইপ: string

          exhibit নম্বর (যেমন '99.1')

        • text
          টাইপ: string

          exhibit-এর কাঁচা টেক্সট কনটেন্ট। শুধু 'include_exhibits' প্যারামিটার true-তে সেট থাকলে অন্তর্ভুক্ত করা হয়।

        • url
          টাইপ: string ফরম্যাট: uri

          SEC ওয়েবসাইটে exhibit ডকুমেন্টের 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 নম্বর

    • estimated_ready_at
      টাইপ: string ফরম্যাট: date-time

      ফাইলিং কখন প্রস্তুত হওয়ার কথা

    • message
      টাইপ: string

      এরপর কী করতে হবে তার মানুষের-পাঠযোগ্য বিবরণ

    • request_id
      টাইপ: string ফরম্যাট: uuid

      এই রিকোয়েস্টের শনাক্তকারী; সহায়তার সঙ্গে যোগাযোগের সময় কাজে লাগে

    • result_url
      টাইপ: string

      ফলাফলের জন্য poll করার URL

    • status
      enum
      const:  
      processing

      202 রেসপন্সে সর্বদা 'processing'

      মান
      • processing
    application/json
  • 400

    রিকোয়েস্ট প্রক্রিয়া করা যায়নি। রিকোয়েস্ট প্যারামিটার যাচাই করুন।

  • 401

    একটি বৈধ Felo API key আবশ্যক।

  • 402

    বিলিং শর্ত পূরণ না হওয়ায় রিকোয়েস্ট এগোতে পারছে না।

  • 403

    অ্যাকাউন্টটিকে এই অপারেশন করার অনুমতি নেই।

  • 429

    রিকোয়েস্ট বা ব্যয়ের সীমায় পৌঁছে গেছে।

  • 502

    পরিষেবা রিকোয়েস্টটি সম্পন্ন করতে পারেনি।

  • 503

    API বা বিলিং পরিষেবা সাময়িকভাবে অনুপলভ্য।

  • 504

    রিকোয়েস্ট প্রক্রিয়াকরণের সময় পরিষেবার সময় শেষ হয়ে গেছে।

  • default

    ত্রুটি রেসপন্স; আপস্ট্রিম passthrough রেসপন্স প্রোভাইডারের ফর্ম্যাট ব্যবহার করতে পারে।

    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