Skip to content

Field Naming Quirks

Victor Kaiuki edited this page Jun 16, 2026 · 1 revision

Field Naming Quirks

The CFTC API contains several persistent typos and inconsistencies. The cftc-cot SDK preserves these exact names to ensure correct API interaction.

API Typos

Field Note
noncomm_postions_spread_all "postions" not "positions"
change_in_noncomm_spead_all "spead" not "spread"
traders_noncomm_spead_old "spead" not "spread"

Double Underscores (Disaggregated)

Field Note
swap__positions_short_all Two underscores
swap__positions_spread_all Two underscores

Inconsistent Suffixes

  • No _all suffix:
    • tot_rept_positions_short (All datasets)
    • pct_of_oi_noncomm_spread (Legacy)
    • prod_merc_positions_long/short (Disaggregated)
    • m_money_positions_spread (Disaggregated)
    • other_rept_positions_long/short/spread (Disaggregated)
    • asset_mgr_positions_long/short/spread (TFF)
    • lev_money_positions_long/short/spread (TFF)

Clone this wiki locally