wiz-trader 0.33.0__tar.gz → 0.35.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: wiz_trader
3
- Version: 0.33.0
3
+ Version: 0.35.0
4
4
  Summary: A Python SDK for connecting to the Wizzer.
5
5
  Home-page: https://bitbucket.org/wizzer-tech/quotes_sdk.git
6
6
  Author: Pawan Wagh
@@ -3290,7 +3290,7 @@ The screener supports filtering instruments using various financial, technical,
3290
3290
  ### Instrument Properties
3291
3291
 
3292
3292
  | Field | Description | Data Type | Supported Operations |
3293
- |-------|-------------|-----------|---------------------|
3293
+ |--- |--- |--- |--- |
3294
3294
  | `exchange` | Stock exchange where the instrument is traded | String | `$eq`, `$ne`, `$in`, `$nin`, `$like`, `$nlike`, `$ilike` |
3295
3295
  | `tradingSymbol` | Trading symbol of the instrument | String | `$eq`, `$ne`, `$in`, `$nin`, `$like`, `$nlike`, `$ilike` |
3296
3296
  | `macroEconomicSector` | Macro economic sector classification | String | `$eq`, `$ne`, `$in`, `$nin`, `$like`, `$nlike`, `$ilike` |
@@ -3300,12 +3300,14 @@ The screener supports filtering instruments using various financial, technical,
3300
3300
  | `indices` | List of indices the instrument belongs to | Array(String) | `$in`, `$nin` |
3301
3301
  | `issuedSize` | Total issued shares (listed shares count) | UInt64 | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3302
3302
  | `marketCap` | Market capitalization (issuedSize × latest closing price) | Float64 | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3303
+ | `logMarketCap` | Logarithm of Market Capitalization | Nullable(Float64) | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3303
3304
 
3304
3305
  ### Financial Data
3305
3306
 
3306
3307
  | Field | Description | Data Type | Unit | Supported Operations |
3307
- |-------|-------------|-----------|------|---------------------|
3308
+ |--- |--- |--- |--- |--- |
3308
3309
  | `reportDate` | Date of the financial report | Date | - | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3310
+ | `latestReportDate_daily` | Date of the latest financial report (daily derived) | Date | - | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3309
3311
  | `companyName` | Company name | String | - | `$eq`, `$ne`, `$like`, `$nlike`, `$ilike` |
3310
3312
  | `period` | Financial reporting period (Q1, Q2, Q3, Q4, FY) | String | - | `$eq`, `$ne`, `$in`, `$nin` |
3311
3313
  | `filingDate` | Date when the report was filed | Date | - | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3316,7 +3318,7 @@ The screener supports filtering instruments using various financial, technical,
3316
3318
 
3317
3319
  ### Interest Income & Expense
3318
3320
  | Field | Description | Data Type | Unit | Supported Operations |
3319
- |-------|-------------|-----------|------|---------------------|
3321
+ |--- |--- |--- |--- |--- |
3320
3322
  | `interestEarnedQuarterly` | Interest Earned - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3321
3323
  | `interestEarnedAnnual` | Interest Earned - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3322
3324
  | `interestExpenseQuarterly` | Interest Expense - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3324,15 +3326,16 @@ The screener supports filtering instruments using various financial, technical,
3324
3326
 
3325
3327
  ### NPA & Asset Quality
3326
3328
  | Field | Description | Data Type | Unit | Supported Operations |
3327
- |-------|-------------|-----------|------|---------------------|
3329
+ |--- |--- |--- |--- |--- |
3328
3330
  | `grossNpaRatioQuarterly` | Gross NPA Ratio - quarterly | Float64 | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3329
3331
  | `grossNpaRatioAnnual` | Gross NPA Ratio - annual | Float64 | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3330
3332
  | `netNpaRatioQuarterly` | Net NPA Ratio - quarterly | Float64 | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3331
3333
  | `netNpaRatioAnnual` | Net NPA Ratio - annual | Float64 | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3334
+ | `gnpaPct` | Gross Non-Performing Assets Percentage | Float | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3332
3335
 
3333
3336
  ### Capital Adequacy
3334
3337
  | Field | Description | Data Type | Unit | Supported Operations |
3335
- |-------|-------------|-----------|------|---------------------|
3338
+ |--- |--- |--- |--- |--- |
3336
3339
  | `cet1RatioQuarterly` | CET1 Capital Ratio - quarterly | Float64 | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3337
3340
  | `cet1RatioAnnual` | CET1 Capital Ratio - annual | Float64 | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3338
3341
  | `tier1CapitalRatioQuarterly` | Tier 1 Capital Ratio - quarterly | Float64 | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3342,7 +3345,7 @@ The screener supports filtering instruments using various financial, technical,
3342
3345
 
3343
3346
  ### Banking Assets & Liabilities
3344
3347
  | Field | Description | Data Type | Unit | Supported Operations |
3345
- |-------|-------------|-----------|------|---------------------|
3348
+ |--- |--- |--- |--- |--- |
3346
3349
  | `advancesQuarterly` | Advances - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3347
3350
  | `advancesAnnual` | Advances - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3348
3351
  | `depositsQuarterly` | Deposits - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3356,7 +3359,7 @@ The screener supports filtering instruments using various financial, technical,
3356
3359
 
3357
3360
  ### Fixed Assets
3358
3361
  | Field | Description | Data Type | Unit | Supported Operations |
3359
- |-------|-------------|-----------|------|---------------------|
3362
+ |--- |--- |--- |--- |--- |
3360
3363
  | `ppeQuarterly` | Property, Plant & Equipment - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3361
3364
  | `ppeAnnual` | Property, Plant & Equipment - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3362
3365
  | `goodwillQuarterly` | Goodwill - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3372,7 +3375,7 @@ The screener supports filtering instruments using various financial, technical,
3372
3375
 
3373
3376
  ### Current Assets
3374
3377
  | Field | Description | Data Type | Unit | Supported Operations |
3375
- |-------|-------------|-----------|------|---------------------|
3378
+ |--- |--- |--- |--- |--- |
3376
3379
  | `inventoriesQuarterly` | Inventories - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3377
3380
  | `inventoriesAnnual` | Inventories - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3378
3381
  | `tradeReceivablesQuarterly` | Trade Receivables - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3384,7 +3387,7 @@ The screener supports filtering instruments using various financial, technical,
3384
3387
 
3385
3388
  ### Total Assets & Equity
3386
3389
  | Field | Description | Data Type | Unit | Supported Operations |
3387
- |-------|-------------|-----------|------|---------------------|
3390
+ |--- |--- |--- |--- |--- |
3388
3391
  | `totalAssetsQuarterly` | Total Assets - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3389
3392
  | `totalAssetsAnnual` | Total Assets - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3390
3393
  | `totalEquityQuarterly` | Total Equity - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3398,7 +3401,7 @@ The screener supports filtering instruments using various financial, technical,
3398
3401
 
3399
3402
  ### Revenue & Income
3400
3403
  | Field | Description | Data Type | Unit | Supported Operations |
3401
- |-------|-------------|-----------|------|---------------------|
3404
+ |--- |--- |--- |--- |--- |
3402
3405
  | `revenueOperationsQuarterly` | Revenue from Operations - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3403
3406
  | `revenueOperationsAnnual` | Revenue from Operations - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3404
3407
  | `otherIncomeQuarterly` | Other Income - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3410,7 +3413,7 @@ The screener supports filtering instruments using various financial, technical,
3410
3413
 
3411
3414
  ### Expenses
3412
3415
  | Field | Description | Data Type | Unit | Supported Operations |
3413
- |-------|-------------|-----------|------|---------------------|
3416
+ |--- |--- |--- |--- |--- |
3414
3417
  | `materialCostQuarterly` | Material Cost - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3415
3418
  | `materialCostAnnual` | Material Cost - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3416
3419
  | `employeeExpenseQuarterly` | Employee Expenses - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3426,7 +3429,7 @@ The screener supports filtering instruments using various financial, technical,
3426
3429
 
3427
3430
  ### Profit & Loss
3428
3431
  | Field | Description | Data Type | Unit | Supported Operations |
3429
- |-------|-------------|-----------|------|---------------------|
3432
+ |--- |--- |--- |--- |--- |
3430
3433
  | `profitBeforeTaxQuarterly` | Profit Before Tax - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3431
3434
  | `profitBeforeTaxAnnual` | Profit Before Tax - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3432
3435
  | `currentTaxQuarterly` | Current Tax - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3437,12 +3440,13 @@ The screener supports filtering instruments using various financial, technical,
3437
3440
  | `taxExpenseAnnual` | Tax Expense - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3438
3441
  | `netProfitQuarterly` | Net Profit - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3439
3442
  | `netProfitAnnual` | Net Profit - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3443
+ | `ebitda` | Earnings Before Interest, Taxes, Depreciation, and Amortization | Nullable(Float64) | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3440
3444
 
3441
3445
  ## Cash Flow Statement
3442
3446
 
3443
3447
  ### Operating Activities
3444
3448
  | Field | Description | Data Type | Unit | Supported Operations |
3445
- |-------|-------------|-----------|------|---------------------|
3449
+ |--- |--- |--- |--- |--- |
3446
3450
  | `operatingCashFlowQuarterly` | Operating Cash Flow - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3447
3451
  | `operatingCashFlowAnnual` | Operating Cash Flow - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3448
3452
  | `netOperatingCashQuarterly` | Net Operating Cash - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3450,7 +3454,7 @@ The screener supports filtering instruments using various financial, technical,
3450
3454
 
3451
3455
  ### Investing Activities
3452
3456
  | Field | Description | Data Type | Unit | Supported Operations |
3453
- |-------|-------------|-----------|------|---------------------|
3457
+ |--- |--- |--- |--- |--- |
3454
3458
  | `investingCashFlowQuarterly` | Investing Cash Flow - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3455
3459
  | `investingCashFlowAnnual` | Investing Cash Flow - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3456
3460
  | `netInvestingCashQuarterly` | Net Investing Cash - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3466,7 +3470,7 @@ The screener supports filtering instruments using various financial, technical,
3466
3470
 
3467
3471
  ### Financing Activities
3468
3472
  | Field | Description | Data Type | Unit | Supported Operations |
3469
- |-------|-------------|-----------|------|---------------------|
3473
+ |--- |--- |--- |--- |--- |
3470
3474
  | `financingCashFlowQuarterly` | Financing Cash Flow - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3471
3475
  | `financingCashFlowAnnual` | Financing Cash Flow - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3472
3476
  | `netFinancingCashQuarterly` | Net Financing Cash - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3484,17 +3488,19 @@ The screener supports filtering instruments using various financial, technical,
3484
3488
 
3485
3489
  ### Net Cash Changes
3486
3490
  | Field | Description | Data Type | Unit | Supported Operations |
3487
- |-------|-------------|-----------|------|---------------------|
3491
+ |--- |--- |--- |--- |--- |
3488
3492
  | `netCashChangeQuarterly` | Net Cash Change - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3489
3493
  | `netCashChangeAnnual` | Net Cash Change - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3490
3494
  | `cashCashflowStmtQuarterly` | Cash from Cashflow Statement - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3491
3495
  | `cashCashflowStmtAnnual` | Cash from Cashflow Statement - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3496
+ | `freeCashFlow` | Free Cash Flow | Nullable(Float64) | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3497
+ | `netCash` | Net Cash Position | Float | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3492
3498
 
3493
3499
  ## NBFC-Specific Metrics
3494
3500
 
3495
3501
  ### Revenue & Income
3496
3502
  | Field | Description | Data Type | Unit | Supported Operations |
3497
- |-------|-------------|-----------|------|---------------------|
3503
+ |--- |--- |--- |--- |--- |
3498
3504
  | `feesCommissionIncomeQuarterly` | Fees & Commission Income - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3499
3505
  | `feesCommissionIncomeAnnual` | Fees & Commission Income - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3500
3506
  | `fairValueGainsQuarterly` | Fair Value Gains - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3504,7 +3510,7 @@ The screener supports filtering instruments using various financial, technical,
3504
3510
 
3505
3511
  ### Expenses
3506
3512
  | Field | Description | Data Type | Unit | Supported Operations |
3507
- |-------|-------------|-----------|------|---------------------|
3513
+ |--- |--- |--- |--- |--- |
3508
3514
  | `feesCommissionExpenseQuarterly` | Fees & Commission Expense - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3509
3515
  | `feesCommissionExpenseAnnual` | Fees & Commission Expense - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3510
3516
  | `fairValueLossesQuarterly` | Fair Value Losses - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3514,7 +3520,7 @@ The screener supports filtering instruments using various financial, technical,
3514
3520
 
3515
3521
  ### NBFC Assets
3516
3522
  | Field | Description | Data Type | Unit | Supported Operations |
3517
- |-------|-------------|-----------|------|---------------------|
3523
+ |--- |--- |--- |--- |--- |
3518
3524
  | `loansQuarterly` | Loans - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3519
3525
  | `loansAnnual` | Loans - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3520
3526
  | `otherFinancialAssetsQuarterly` | Other Financial Assets - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3524,7 +3530,7 @@ The screener supports filtering instruments using various financial, technical,
3524
3530
 
3525
3531
  ### Premium Income
3526
3532
  | Field | Description | Data Type | Unit | Supported Operations |
3527
- |-------|-------------|-----------|------|---------------------|
3533
+ |--- |--- |--- |--- |--- |
3528
3534
  | `grossPremiumIncomeQuarterly` | Gross Premium Income - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3529
3535
  | `grossPremiumIncomeAnnual` | Gross Premium Income - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3530
3536
  | `netPremiumIncomeQuarterly` | Net Premium Income - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3532,7 +3538,7 @@ The screener supports filtering instruments using various financial, technical,
3532
3538
 
3533
3539
  ### Insurance Ratios
3534
3540
  | Field | Description | Data Type | Unit | Supported Operations |
3535
- |-------|-------------|-----------|------|---------------------|
3541
+ |--- |--- |--- |--- |--- |
3536
3542
  | `solvencyRatioQuarterly` | Solvency Ratio - quarterly | Float64 | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3537
3543
  | `solvencyRatioAnnual` | Solvency Ratio - annual | Float64 | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3538
3544
  | `expensesOfManagementRatioQuarterly` | Expenses of Management Ratio - quarterly | Float64 | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3540,46 +3546,70 @@ The screener supports filtering instruments using various financial, technical,
3540
3546
 
3541
3547
  ## Financial Ratios
3542
3548
 
3549
+ ### Valuation Ratios
3550
+ | Field | Description | Data Type | Unit | Supported Operations |
3551
+ |--- |--- |--- |--- |--- |
3552
+ | `peRatio` | Price-to-Earnings Ratio | Nullable(Float32) | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3553
+ | `pbRatio` | Price-to-Book Ratio | Nullable(Float32) | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3554
+ | `evEbitda` | Enterprise Value to EBITDA Ratio | Nullable(Float32) | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3555
+ | `fcfYield` | Free Cash Flow Yield | Nullable(Float32) | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3556
+
3543
3557
  ### Leverage Ratios
3544
3558
  | Field | Description | Data Type | Unit | Supported Operations |
3545
- |-------|-------------|-----------|------|---------------------|
3559
+ |--- |--- |--- |--- |--- |
3546
3560
  | `debtEquityRatioQuarterly` | Debt to Equity Ratio - quarterly | Float64 | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3547
3561
  | `debtEquityRatioAnnual` | Debt to Equity Ratio - annual | Float64 | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3562
+ | `debtEquity` | Debt to Equity Ratio | Float | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3548
3563
  | `debtServiceRatioQuarterly` | Debt Service Ratio - quarterly | Float64 | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3549
3564
  | `debtServiceRatioAnnual` | Debt Service Ratio - annual | Float64 | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3550
3565
  | `interestCoverageRatioQuarterly` | Interest Coverage Ratio - quarterly | Float64 | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3551
3566
  | `interestCoverageRatioAnnual` | Interest Coverage Ratio - annual | Float64 | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3567
+ | `interestCov` | Interest Coverage Ratio | Float | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3552
3568
 
3553
3569
  ### Profitability Ratios
3554
3570
  | Field | Description | Data Type | Unit | Supported Operations |
3555
- |-------|-------------|-----------|------|---------------------|
3571
+ |--- |--- |--- |--- |--- |
3556
3572
  | `basicEpsQuarterly` | Basic EPS - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3557
3573
  | `basicEpsAnnual` | Basic EPS - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3558
3574
  | `dilutedEpsQuarterly` | Diluted EPS - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3559
3575
  | `dilutedEpsAnnual` | Diluted EPS - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3560
3576
  | `roe` | Return on Equity | Float | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3577
+ | `roa` | Return on Assets | Nullable(Float32) | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3561
3578
  | `patMargin` | Profit After Tax Margin | Float | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3579
+ | `grossMargin` | Gross Profit Margin | Nullable(Float32) | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3580
+ | `operatingMargin` | Operating Profit Margin | Nullable(Float32) | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3581
+ | `ebitMargin` | Earnings Before Interest and Taxes Margin | Nullable(Float32) | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3562
3582
 
3563
3583
  ### Efficiency Ratios
3564
3584
  | Field | Description | Data Type | Unit | Supported Operations |
3565
- |-------|-------------|-----------|------|---------------------|
3585
+ |--- |--- |--- |--- |--- |
3566
3586
  | `assetTurnover` | Asset Turnover Ratio | Float | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3567
3587
  | `currentRatio` | Current Ratio | Float | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3568
3588
  | `ocfPat` | Operating Cash Flow to PAT Ratio | Float | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3589
+ | `ocfNetProfit` | Operating Cash Flow to Net Profit Ratio | Nullable(Float32) | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3590
+
3591
+ ## Technical Indicators
3569
3592
 
3570
- ### Other Financial Metrics
3571
3593
  | Field | Description | Data Type | Unit | Supported Operations |
3572
- |-------|-------------|-----------|------|---------------------|
3573
- | `debtEquity` | Debt to Equity Ratio | Float | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3574
- | `interestCov` | Interest Coverage Ratio | Float | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3575
- | `netCash` | Net Cash Position | Float | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3576
- | `gnpaPct` | Gross Non-Performing Assets Percentage | Float | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3594
+ |--- |--- |--- |--- |--- |
3595
+ | `fiftyDayMA` | 50-Day Moving Average | Nullable(Float32) | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3596
+ | `hundredDayMA` | 100-Day Moving Average | Nullable(Float32) | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3597
+ | `twoHundredDayMA` | 200-Day Moving Average | Nullable(Float32) | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3598
+ | `rsi` | Relative Strength Index | Nullable(Float32) | index | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3599
+ | `macd` | Moving Average Convergence Divergence | Nullable(Float32) | index | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3600
+ | `macdSignal` | MACD Signal Line | Nullable(Float32) | index | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3601
+ | `bollingerUpper` | Bollinger Band Upper | Nullable(Float32) | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3602
+ | `bollingerLower` | Bollinger Band Lower | Nullable(Float32) | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3603
+ | `atr` | Average True Range | Nullable(Float32) | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3604
+ | `volumeRatio` | Volume Ratio | Nullable(Float32) | ratio | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3605
+ | `thirtyDayVolatility` | 30-Day Volatility | Nullable(Float32) | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3606
+ | `sixMMaxDrawdown` | Six Month Maximum Drawdown | Nullable(Float32) | % | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3577
3607
 
3578
3608
  ## Segment Analysis
3579
3609
 
3580
3610
  ### Segment Financial Data
3581
3611
  | Field | Description | Data Type | Unit | Supported Operations |
3582
- |-------|-------------|-----------|------|---------------------|
3612
+ |--- |--- |--- |--- |--- |
3583
3613
  | `segmentRevenueQuarterly` | Segment Revenue - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3584
3614
  | `segmentRevenueAnnual` | Segment Revenue - annual | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3585
3615
  | `segmentProfitBeforeTaxQuarterly` | Segment Profit Before Tax - quarterly | Float64 | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3592,7 +3622,7 @@ The screener supports filtering instruments using various financial, technical,
3592
3622
  ### Historical Market Data
3593
3623
 
3594
3624
  | Field | Description | Data Type | Unit | Supported Operations |
3595
- |-------|-------------|-----------|------|---------------------|
3625
+ |--- |--- |--- |--- |--- |
3596
3626
  | `hmdOpen` | Opening price of the trading session | Float | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3597
3627
  | `hmdHigh` | Highest price during the trading session | Float | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
3598
3628
  | `hmdLow` | Lowest price during the trading session | Float | currency | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$between` |
@@ -3633,3 +3663,243 @@ results = client.run_screener(
3633
3663
  limit=10
3634
3664
  )
3635
3665
  ```
3666
+
3667
+ ## KV Store Integration
3668
+
3669
+ The WizzerClient includes comprehensive Key-Value (KV) store functionality for persistent data management. This feature allows you to store configuration data, state information, user preferences, and other persistent data associated with your trading strategies.
3670
+
3671
+ ### Supported Data Types
3672
+
3673
+ The KV store supports all JSON-serializable data types:
3674
+
3675
+ - **STRING**: Text values (`"production"`, `"user123"`)
3676
+ - **NUMBER**: Integer and float values (`42`, `150.25`)
3677
+ - **BOOLEAN**: True/false values (`True`, `False`)
3678
+ - **ARRAY**: Lists of values (`["AAPL", "GOOGL", "MSFT"]`)
3679
+ - **OBJECT**: Dictionaries/objects (`{"positions": 30, "cash": 50000}`)
3680
+
3681
+ ### Available Constants
3682
+
3683
+ ```python
3684
+ client.KV_TYPE_STRING # "string"
3685
+ client.KV_TYPE_NUMBER # "number"
3686
+ client.KV_TYPE_BOOLEAN # "boolean"
3687
+ client.KV_TYPE_ARRAY # "array"
3688
+ client.KV_TYPE_OBJECT # "object"
3689
+ ```
3690
+
3691
+ ### Core CRUD Operations
3692
+
3693
+ #### Create Key-Value Pair
3694
+
3695
+ ```python
3696
+ # Store different data types
3697
+ client.create_kv("environment", "production")
3698
+ client.create_kv("trade_count", 42)
3699
+ client.create_kv("is_active", True)
3700
+ client.create_kv("symbols", ["AAPL", "GOOGL", "MSFT"])
3701
+
3702
+ # Store complex configuration with TTL (expires in 1 hour)
3703
+ config = {
3704
+ "risk_level": "medium",
3705
+ "max_positions": 10,
3706
+ "stop_loss_pct": 0.05,
3707
+ "take_profit_pct": 0.15
3708
+ }
3709
+ client.create_kv("strategy_config", config, ttl=3600)
3710
+ ```
3711
+
3712
+ #### Retrieve Key-Value Pair
3713
+
3714
+ ```python
3715
+ # Get a single KV pair
3716
+ data = client.get_kv("strategy_config")
3717
+ print(data["value"]) # The stored object
3718
+ print(data["type"]) # "object"
3719
+ print(data["ttl"]) # Remaining time to live (if set)
3720
+
3721
+ # Access nested values
3722
+ risk_level = data["value"]["risk_level"] # "medium"
3723
+ ```
3724
+
3725
+ #### Update Key-Value Pair (Complete Replacement)
3726
+
3727
+ ```python
3728
+ # Complete replacement of existing key
3729
+ new_config = {"risk_level": "high", "max_positions": 5}
3730
+ client.update_kv("strategy_config", new_config, ttl=1800)
3731
+ ```
3732
+
3733
+ #### Patch Key-Value Pair (Partial Update)
3734
+
3735
+ ```python
3736
+ # For objects - merges with existing data
3737
+ client.patch_kv("strategy_config", {"last_updated": "2024-01-15"})
3738
+
3739
+ # For non-objects - replaces entirely
3740
+ client.patch_kv("trade_count", 50)
3741
+
3742
+ # Update only TTL
3743
+ client.patch_kv("strategy_config", ttl=7200)
3744
+ ```
3745
+
3746
+ #### Delete Key-Value Pair
3747
+
3748
+ ```python
3749
+ response = client.delete_kv("old_config")
3750
+ if response["success"]:
3751
+ print("Key deleted successfully")
3752
+ ```
3753
+
3754
+ ### List Operations
3755
+
3756
+ #### Get All KV Pairs (with values)
3757
+
3758
+ ```python
3759
+ # Get first page (20 items)
3760
+ kvs = client.get_all_kvs(page_no=1)
3761
+
3762
+ # Get all pages automatically
3763
+ all_kvs = client.get_all_kvs(paginate=True)
3764
+
3765
+ for kv in all_kvs:
3766
+ print(f"Key: {kv['key']}")
3767
+ print(f"Type: {kv['type']}")
3768
+ print(f"Value: {kv['value']}")
3769
+ ```
3770
+
3771
+ #### Get Keys Only (memory efficient)
3772
+
3773
+ ```python
3774
+ # Get all keys without values (faster for large datasets)
3775
+ keys = client.get_kv_keys(paginate=True)
3776
+
3777
+ for key_info in keys:
3778
+ print(f"Key: {key_info['key']}, Type: {key_info['type']}")
3779
+ if 'ttl' in key_info:
3780
+ print(f" TTL: {key_info['ttl']} seconds remaining")
3781
+ ```
3782
+
3783
+ ### Advanced Usage Examples
3784
+
3785
+ #### Strategy Configuration Management
3786
+
3787
+ ```python
3788
+ # Store strategy parameters
3789
+ params = {
3790
+ "moving_average_period": 20,
3791
+ "rsi_oversold": 30,
3792
+ "rsi_overbought": 70,
3793
+ "position_size": 0.02
3794
+ }
3795
+ client.create_kv("strategy_params", params)
3796
+
3797
+ # Update specific parameters using patch (merges with existing)
3798
+ client.patch_kv("strategy_params", {"moving_average_period": 50})
3799
+ ```
3800
+
3801
+ #### State Persistence
3802
+
3803
+ ```python
3804
+ # Save current portfolio state
3805
+ portfolio_state = {
3806
+ "cash_balance": 50000,
3807
+ "open_positions": 5,
3808
+ "daily_pnl": 1250.75,
3809
+ "last_updated": "2024-01-15T15:30:00Z"
3810
+ }
3811
+ client.create_kv("portfolio_state", portfolio_state, ttl=3600)
3812
+
3813
+ # Update state periodically
3814
+ client.patch_kv("portfolio_state", {
3815
+ "daily_pnl": 1500.25,
3816
+ "last_updated": "2024-01-15T16:00:00Z"
3817
+ })
3818
+ ```
3819
+
3820
+ #### Feature Flags
3821
+
3822
+ ```python
3823
+ # Enable/disable features dynamically
3824
+ features = {
3825
+ "advanced_charts": True,
3826
+ "paper_trading": True,
3827
+ "options_trading": False,
3828
+ "algo_trading": True
3829
+ }
3830
+ client.create_kv("feature_flags", features)
3831
+
3832
+ # Toggle a feature
3833
+ client.patch_kv("feature_flags", {"options_trading": True})
3834
+ ```
3835
+
3836
+ #### Data Caching with TTL
3837
+
3838
+ ```python
3839
+ # Cache market data with short TTL (5 minutes)
3840
+ market_status = {
3841
+ "nse_open": True,
3842
+ "bse_open": True,
3843
+ "last_checked": "2024-01-15T09:15:00Z"
3844
+ }
3845
+ client.create_kv("market_status", market_status, ttl=300)
3846
+ ```
3847
+
3848
+ ### Object Merge Behavior
3849
+
3850
+ For OBJECT type data, the `patch_kv` method performs intelligent merging:
3851
+
3852
+ ```python
3853
+ # Initial object
3854
+ client.create_kv("user_prefs", {
3855
+ "theme": "dark",
3856
+ "notifications": True,
3857
+ "language": "en"
3858
+ })
3859
+
3860
+ # Patch merges new fields with existing ones
3861
+ client.patch_kv("user_prefs", {
3862
+ "notifications": False, # Updates existing field
3863
+ "timezone": "UTC" # Adds new field
3864
+ })
3865
+
3866
+ # Result: {"theme": "dark", "notifications": False, "language": "en", "timezone": "UTC"}
3867
+ ```
3868
+
3869
+ ### Delete All KV Pairs
3870
+
3871
+ The `delete_all_kv` method allows you to remove all key-value pairs for a strategy at once:
3872
+
3873
+ ```python
3874
+ # Delete all KV pairs for the current strategy
3875
+ response = client.delete_all_kv()
3876
+ print(f"Deleted {response['deleted']} key-value pairs")
3877
+
3878
+ # Example response:
3879
+ # {
3880
+ # "success": True,
3881
+ # "deleted": 15,
3882
+ # "message": "Successfully deleted 15 key-value pairs"
3883
+ # }
3884
+
3885
+ # Common usage - reset strategy state before reinitialization
3886
+ def reset_strategy_state():
3887
+ """Reset all persistent state for the strategy."""
3888
+ # Clear all existing KV pairs
3889
+ result = client.delete_all_kv()
3890
+ print(f"Cleared {result['deleted']} KV pairs")
3891
+
3892
+ # Reinitialize with default configuration
3893
+ client.create_kv("config", {
3894
+ "mode": "production",
3895
+ "risk_percentage": 0.02,
3896
+ "max_positions": 10
3897
+ })
3898
+ client.create_kv("state", {
3899
+ "initialized": True,
3900
+ "start_time": datetime.now().isoformat()
3901
+ })
3902
+ print("Strategy state reset successfully")
3903
+
3904
+ # Use with caution - this operation cannot be undone!
3905
+ ```