size_categories:10K<n<100K format:parquet modality:text library:datasets library:dask library:mlcroissant library:polars region:us
---
dataset_info:
  features:
  - name: submission
    struct:
    - name: cik
      dtype: string
    - name: company_name
      dtype: string
    - name: form_type
      dtype: string
    - name: date_filed
      dtype: timestamp[s]
    - name: master_file
      dtype: string
    - name: submission_filename
      dtype: string
    - name: submission_url
      dtype: string
    - name: accession_number
      dtype: string
  - name: header
    struct:
    - name: sec_document
      dtype: string
    - name: acceptance_datetime
      dtype: string
    - name: filing_form_type
      dtype: string
    - name: submission_type
      dtype: string
    - name: conformed_submission_type
      dtype: string
    - name: period_of_report
      dtype: string
    - name: conformed_period_of_report
      dtype: string
    - name: standard_industrial_classification
      dtype: string
    - name: classification_number
      dtype: string
    - name: accession_number
      dtype: string
    - name: public_document_count
      dtype: string
    - name: company_name
      dtype: string
    - name: sec_header
      dtype: string
    - name: filing_date
      dtype: string
    - name: sec-header-complete
      dtype: string
  - name: document_from_text
    dtype: string
  - name: document_metadata
    struct:
    - name: document_type
      dtype: string
    - name: sequence
      dtype: string
    - name: document_filename
      dtype: string
    - name: description
      dtype: string
    - name: title
      dtype: string
  - name: _id
    dtype: string
  - name: timestamp_collection
    dtype: string
  - name: doc_url
    dtype: string
  - name: raw_document_content
    dtype: string
  splits:
  - name: train
    num_bytes: 4527053033
    num_examples: 12492
  download_size: 1058913123
  dataset_size: 4527053033
configs:
- config_name: default
  data_files:
  - split: train
    path: data/train-*
---
# Dataset Card for SEC Exhibit 10 Material Contracts Dataset

## Dataset Details

### Dataset Description

This training dataset contains SEC filing documents specifically focused on Exhibit 10 (Material Contracts) from a specified quarter. Exhibit 10 includes material contracts and similar agreements that are required to be filed with the SEC. This collection provides structured access to full contract texts and associated metadata.

- **Curated by:** Arthur (arthur@cicero.chat)
- **Language(s):** English
- **License:** Likely public domain as US government data
- **Scope:** Material contracts filed as Exhibit 10 in SEC filings

## Dataset Structure

The dataset has a nested structure with the following fields:

### Top Level Fields
1. **submission**: Dictionary containing the full submission data
   - Type: dict
   - Contains nested document and header information

2. **header**: Dictionary containing filing header information
   - Type: dict
   - Contains SEC header metadata

3. **document_from_text**: String containing contract text
   - Type: string
   - Length: Variable
   - Contains the full text of material contracts

4. **document_metadata**: Dictionary containing document-specific metadata
   - Type: dict
   - Contains filing metadata like CIK, form type, dates, etc.

5. **_id**: Unique identifier
   - Type: string
   - Present in all records

6. **timestamp_collection**: Timestamp of when record was collected
   - Type: string
   - Present in all records

7. **doc_url**: URL to the document on SEC website
   - Type: string
   - Present in all records

8. **raw_document_content**: Raw document content
   - Type: string
   - Contains unprocessed contract text and markup

### Document Metadata Fields
The document_metadata dictionary contains:
- cik: Company identifier
- company_name: Name of filing company
- form_type: Type of SEC form (all Exhibit 10 variants)
- date_filed: Filing date
- master_file: Reference to master index file
- submission_filename: Path to filing in EDGAR system
- submission_url: Direct link to filing
- accession_number: SEC accession number

### Header Fields
The header dictionary includes:
- sec_document: Document identifier and date
- acceptance_datetime: Filing acceptance timestamp
- filing_form_type: Type of SEC form
- submission_type: Type of submission
- period_of_report: Report period
- standard_industrial_classification: Industry classification
- classification_number: Industry code
- public_document_count: Number of documents in submission
- company_name: Filing company name

## Uses

### Direct Use
- Analysis of material business contracts
- Corporate relationship mapping
- Contract term analysis
- Legal document processing
- Identification of business arrangements and terms
- Research on contract structures and patterns
- Corporate governance analysis

### Out-of-Scope Use
- Analysis of other SEC filing types
- Real-time contract monitoring
- Legal advice or compliance determinations
- Analysis of non-material contracts
- Trading signals without proper analysis

## Limitations and Considerations

- Limited to material contracts (Exhibit 10)
- Focused on a specific quarter
- Large variance in document sizes
- Contains HTML/XML markup requiring processing
- May not include all exhibits referenced in contracts
- Historical data only

## Recommendations

- Implement proper HTML/XML parsing for clean text extraction
- Consider contract structure when processing documents
- Cross-reference with master index for complete context
- Consider industry classification when analyzing contracts
- Validate document completeness
- Process tables and formatted content appropriately
- Consider legal expertise for proper interpretation

## Dataset Card Contact

Arthur (arthur@cicero.chat)

## Code 
https://github.com/arthrod/sec-edgar-bulker