Enumerations

The package root exports four enums:

from pacifico import Country, Fixing, Quality, VersionType

Use enum members—not strings or integer values—for fixing, quality, and versionType on value/report requests.

Country

country may use these enum members or their supported names.

Member Value Accepted string
Country.Country_RiskFactors -1 Risk Factors or RiskFactors
Country.Country_Unspecified 0 Unknown/empty fallback
Country.Country_Chile 1 Chile
Country.Country_Colombia 2 Colombia
Country.Country_Peru 3 Peru
Country.Country_Mexico 4 Mexico
Country.Country_Argentina 5 Argentina
Country.Country_United_States 6 United States
Country.Country_Europe 7 Europe
Country.Country_Japan 8 Japan
Country.Country_International 999 International

Conversion is case-insensitive:

Country.fromString("chile") is Country.Country_Chile

Country.fromString silently returns Country_Unspecified for unsupported strings. Country.getString(member) turns a member into a display name.

The client enum intentionally reflects only the members in this package release. In particular, the server currently has a Brazil member that this client does not expose; country="Brazil" therefore falls back to Country_Unspecified in this release. Do not substitute a server-side enum table—the two can evolve independently.

VersionType

Member Value Display string
VersionType.Version_Unspecified 0 Unspecified
VersionType.Version_Pricing 1 Pricing
VersionType.Version_Prediction 2 Prediction

When the request builder receives Version_Unspecified:

  • an empty version makes the effective type Pricing;
  • a non-empty version makes the effective type Prediction.

VersionType.fromString recognizes the exact title-case display strings and otherwise returns Unspecified. The public request itself expects the enum rather than a string.

Current report paths and ticker-specific value paths do not enforce the resulting version predicate. A ticker list is still ticker-specific for this purpose; see request limitations.

Quality

Member Value Display string
Quality.Quality_Unspecified 0 Unspecified
Quality.Quality_Production 1 Production
Quality.Quality_Certification 2 Certification
Quality.Quality_Development 3 Development

Quality.fromString recognizes exact title-case strings and otherwise returns Unspecified. Quality.getString returns the display string.

Fixing

Fixing.EOD has numeric value -1. Its helper maps it to 17:00:00 when constructing an effective time from a publication date.

All remaining members represent 30-minute slots:

F_0000  F_0030  F_0100  F_0130  F_0200  F_0230
F_0300  F_0330  F_0400  F_0430  F_0500  F_0530
F_0600  F_0630  F_0700  F_0730  F_0800  F_0830
F_0900  F_0930  F_1000  F_1030  F_1100  F_1130
F_1200  F_1230  F_1300  F_1330  F_1400  F_1430
F_1500  F_1530  F_1600  F_1630  F_1700  F_1730
F_1800  F_1830  F_1900  F_1930  F_2000  F_2030
F_2100  F_2130  F_2200  F_2230  F_2300  F_2330

Their numeric values use HHMM expressed as an integer:

Examples Values
F_0000, F_0030 0, 30
F_0900, F_0930 900, 930
F_1700, F_1730 1700, 1730
F_2300, F_2330 2300, 2330

Fixing.getTime(member) returns (hour, minute, second) and requires a Fixing member. Fixing.getString(member) returns the enum name.

Not public request enums

Two concepts use strings at the root API:

  • fieldType uses the supported field strings in the request reference;
  • format uses json, dictionary/dict, or dataFrame/df.

Internal FieldType, Format, and report ValueType enums are not re-exported from pacifico.__init__. Avoid importing them as part of an application contract.