pyth-network_pyth-crosschain/apps/api-reference/src/apis/evm/get-ema-price-unsafe.ts

import { readApi, solidity, ethersJS } from "./common";
import { ParameterType } from "../../components/EvmApi";

export const getEmaPriceUnsafe = readApi<"id">({
  name: "getEmaPriceUnsafe",
  summary:
    "Get the **last updated** exponentially weighted moving average (EMA) price object for the requested price feed ID. _Caution: This function may return a price arbitrarily in the past_",
  description: `
  This method returns the price object containing **last updated** exponentially-weighted moving average(EMA) price for the requested price feed ID.

  **This function may return a price from arbitrarily far in the past.** It is the
  caller's responsibility to check the returned \`publishTime\` to ensure that the
  update is recent enough for their use case. If you need the latest price, update the price using [\`updatePriceFeeds()\`](updatePriceFeeds) and then call [\`getEmaPrice()\`](getEmaPrice).

  The \`price\` object contains the following fields:
  1. \`price\`: The latest price of the price feed.
  2. \`conf\`: The confidence level of the price feed.
  3. \`expo\`: The exponent of the price feed.
  4. \`publishtime\`: The time when the price feed was last updated.

  Sample \`price\` object:
  \`\`\`json
  {
      price: 123456789,
      conf: 180726074,
      expo: -8,
      publishTime: 1721765108
  }
  \`\`\`

  The price above is in the format of \`price * 10^expo\`. So, the price in above
  mentioned sample represents the number \`123456789 * 10(-8) = 1.23456789\` in
  this case.

  ### Error Response

  The above method can return the following error response:
  - \`StalePrice\`: The on-chain price has not been updated within the last
    [\`getValidTimePeriod()\`](getValidTimePeriod) seconds. Try calling
    [\`updatePriceFeeds()\`](updatePriceFeeds) to update the price feed with the
    latest price.
  - \`PriceFeedNotFound\`: The requested price feed has never received a price
    update or does not exist. Try calling
    [\`updatePriceFeeds()\`](updatePriceFeeds) to update the price feed.
  `,
  parameters: [
    {
      name: "id",
      type: ParameterType.PriceFeedId,
      description: "The ID of the price feed you want to read",
    },
  ],
  code: [
    solidity(
      ({ id }) => `
bytes32 priceId = ${id ?? "/* <id> */"};
PythStructs.Price memory currentBasePrice = pyth.getEmaPriceUnsafe(priceId);
    `,
    ),
    ethersJS(
      ({ id }) => `
const priceId = ${id ? `'${id}'` : "/* <id> */"};
const [price, conf, expo, timestamp] = await contract.getEmaPriceUnsafe(priceId);
    `,
    ),
  ],
});