Request values¶

Value requests retrieve observations associated with financial instruments. They are selected whenever app is empty and every report selector is empty.

Instrument hierarchy¶

Selectors follow this hierarchy:

Country → Market → Group → Family → Ticker

Each non-empty selector narrows the request. Examples in this site use identifiers found in the repository tutorials; always use metadata to confirm the identifiers available to your token.

One ticker¶

import pacifico

data = pacifico.request(
    "token.key",
    ticker="BCP0600323",
)

Multiple tickers¶

ticker is the only instrument selector that explicitly accepts a list:

portfolio = pacifico.request(
    "token.key",
    ticker=["CHILE", "BCP0600323"],
)

Use a Python list. family, group, market, and report selectors must be strings; tuples and lists are rejected by their field validators.

Broader selectors¶

family_data = pacifico.request("token.key", family="BCP")
group_data = pacifico.request("token.key", group="BT")
market_data = pacifico.request("token.key", market="RF")
country_data = pacifico.request("token.key", country="Chile")

A broader request can return substantially more data and take longer. Prefer metadata-driven selection and the narrowest selector appropriate to the task.

Countries¶

country accepts a supported country name or an exported Country enum:

from pacifico import Country

by_name = pacifico.request("token.key", country="Chile")
by_enum = pacifico.request(
    "token.key",
    country=Country.Country_Chile,
)

Name conversion is case-insensitive. Unknown names silently map to Country_Unspecified, so applications should validate user input rather than relying on the client's fallback. See Enumerations for the exact client-side country set.

Select a field¶

Use fieldType to select one value field:

price = pacifico.request(
    "token.key",
    ticker="BCP0600323",
    fieldType="Price",
)

Supported strings, compared case-insensitively, are:

fieldType	Typical meaning
Price	Full or dirty price
Yield	Yield measure
Duration	Duration measure
Convexity	Convexity measure
Delta	Delta sensitivity
Gamma	Gamma sensitivity
Vega	Vega sensitivity
Volatility	Volatility measure
Quote	Full quote
Clean Price	Clean price
Clean Quote	Clean quote
Market Presence	Market-presence measure
empty or Unspecified	All available fields

An unsupported string also becomes “unspecified” without raising. The public keyword is fieldType; the older tutorial wording “dataType” is conceptual, not a valid replacement keyword. Because unknown extra keywords are ignored on value requests, dataType="Price" would not filter anything.

Publication fixing¶

from pacifico import Fixing

morning = pacifico.request(
    "token.key",
    ticker="CHILE",
    fixing=Fixing.F_0930,
    format="json",
)

Pass a Fixing enum, not the string "F_0930". Fixing.EOD is the default. Intraday enum members are defined every 30 minutes from F_0000 through F_2330.

Use JSON or dictionary output for intraday values. The server appends the fixing to the publication-date key (for example, 31/07/2026-F_0930), while this client release's value DataFrame converter expects a plain DD/MM/YYYY key and can return an error row for that response.

Version and source selectors¶

from pacifico import Quality, VersionType

selected = pacifico.request(
    "token.key",
    family="BCP",
    author="Pacifico",
    versionType=VersionType.Version_Pricing,
    version="",
    quality=Quality.Quality_Production,
)

The client builds version selection as follows:

• Version_Unspecified with an empty version becomes Version_Pricing.
• Version_Unspecified with a non-empty version becomes Version_Prediction.
• An explicit VersionType remains unchanged.

The public author and response display label are both Pacifico. Legacy internal provider identifiers are normalized to that label when results are returned, so validate Scenario values against the public label.

quality accepts only a Quality enum. Entitlements and server-side availability determine which quality levels are returned.

Market factors¶

The tutorials distinguish:

Market	Group examples	Meaning
MF	CF, DF, PF	Direct credit, discount, and parity factors
MF*	CF*, DF*	Factors interpolated to standard tenors

An asterisk denotes the interpolated hierarchy. Examples of discount-factor families include CLP@Chile, UF@Chile, USD@SOFR and their starred counterparts.

Market-factor and ALGO markets are excluded from general latest-value queries unless the request identifies the relevant market, group, family, or ticker. Ask for them explicitly:

discount_factors = pacifico.request(
    "token.key",
    market="MF",
    group="DF",
)

Historical values¶

from datetime import date, timedelta

end = date.today()
start = end - timedelta(days=7)

history = pacifico.request(
    "token.key",
    ticker="CHILE",
    dateStart=start,
    dateEnd=end,
)

For reliable multi-day history, specify at least one ticker and use a non-prediction version type. Single-date and short broad-range behavior has additional rules documented in Dates and history.

Interpret the result¶

The default DataFrame has these columns:

Scenario, Date Publication, Date Effective, Country, Market, Group,
Family, Ticker, Value, Field, Date Tenor, Other

One instrument can therefore occupy multiple rows—one for each returned field, date, scenario, and tenor. See Formats and schemas before assuming uniqueness or pivoting.