docs: more detailed oracle docs

Signed-off-by: Brendan Graetz <bguiz@users.noreply.github.com>

Author: bguiz

.gitbook/developers-evm/oracle-precompile.mdx

@@ -1,20 +1,61 @@
 ---
 title: Oracle Precompile
+description: Approaches for querying price data on Injective, including native oracle queries, off-chain Pyth, and on-chain Pyth via EVM.
 ---
 
-import { Callout } from "@/components/ui";
+<Info>
+  The Oracle Precompile is not yet available.
+  In the meantime, you can query prices using one of the approaches described below.
+</Info>
 
-<Callout type="warning">
-  The Oracle Precompile is not yet available. In the meantime, you can query
-  prices directly from the Pyth contract deployed on Injective's EVM. Note that
-  not all price feeds are available — see the supported feeds below.
-</Callout>
+Injective offers multiple ways to access oracle price data depending on your architecture and requirements.
+The following approaches range from querying Injective's native oracle module directly, to integrating with Pyth off-chain,
+to reading Pyth prices on-chain through Injective's EVM.
 
-## Querying Pyth Prices on Injective EVM
+## Approach 1: Query the native oracle module
 
-Pyth is deployed at `0x36825bf3Fbdf5a29E2d5148bfe7Dcf7B5639e320` on Injective's EVM. You can use it to query prices for the supported feeds listed below.
+You can query price data directly from Injective's native [oracle module](/developers-native/injective/oracle/index),
+which aggregates feeds from multiple providers including Band, Coinbase, and Pyth.
 
-### Supported Feeds
+The [injective-price-oracle](https://github.com/InjectiveLabs/injective-price-oracle) repository
+provides a reference implementation for querying the native oracle module programmatically.
+This approach is well-suited for applications that need access to Injective-native price feeds without relying on third-party EVM contracts.
+
+For full details on the oracle module's state, messages, and supported providers,
+see the [oracle module documentation](/developers-native/injective/oracle/index).
+
+## Approach 2: Off-chain price feeds with Pyth
+
+If your application fetches prices off-chain (for example, in a backend service or bot),
+you can query Pyth's HTTP API directly without any on-chain interaction.
+
+Refer to the Pyth documentation on [fetching price updates](https://docs.pyth.network/price-feeds/core/fetch-price-updates)
+for details on available endpoints, request formats, and response schemas.
+
+This approach is ideal for off-chain trading systems, analytics dashboards,
+or any service that requires price data without submitting transactions.
+
+## Approach 3: On-chain price feeds with Pyth (EVM)
+
+For smart contracts that need to read prices on-chain, you can interact with the Pyth contract deployed on Injective's EVM.
+This uses Pyth's pull-based oracle model, where price updates are fetched off-chain and submitted on-chain before reading.
+
+### Contract addresses
+
+To obtain the Pyth contract address for Injective EVM, refer to the Pyth contract addresses page and locate the **Injective EVM** entry:
+
+- [Mainnet contract addresses](https://docs.pyth.network/price-feeds/core/contract-addresses/evm#mainnets)
+- [Testnet contract addresses](https://docs.pyth.network/price-feeds/core/contract-addresses/evm#testnets)
+
+Currently, Pyth is deployed at `0x36825bf3Fbdf5a29E2d5148bfe7Dcf7B5639e320` on Injective's EVM mainnet.
+
+### Price feed IDs
+
+Each asset pair has a unique price feed ID. You can look up feed IDs on
+the [Pyth price feed IDs](https://docs.pyth.network/price-feeds/core/price-feeds/price-feed-ids) page.
+For example, search for `INJ/USD`.
+
+### Supported feeds
 
 | Asset    | Price Feed ID                                                        |
 | -------- | -------------------------------------------------------------------- |
@@ -25,6 +66,15 @@ Pyth is deployed at `0x36825bf3Fbdf5a29E2d5148bfe7Dcf7B5639e320` on Injective's
 | USDT/USD | `0x2b89b9dc8fdf9f34709a5b106b472f0f39bb6ca9ce04b0fd7f2e971688e2e53b` |
 | USDC/USD | `0xeaa020c61cc479712813461ce153894a96a6c00b21ed0cfc2798d1f9a9e9c94a` |
 
+### Integration guide
+
+For a complete walkthrough of integrating Pyth price feeds into your Solidity contracts using the pull model,
+follow the [Pyth EVM pull integration tutorial](https://docs.pyth.network/price-feeds/core/use-real-time-data/pull-integration/evm).
+
+### Example
+
+The following example demonstrates how to read the INJ/USD price from the Pyth contract on Injective's EVM:
+
 ```typescript
 import { ethers } from "ethers";
 import { toHumanReadable } from "@injectivelabs/utils";
@@ -120,9 +170,11 @@ async function main() {
 main().catch(console.error);
 ```
 
-<Callout type="info">
+<Warning>
   `getPriceUnsafe` returns the last pushed price without a staleness check. For
   production use, prefer `getPriceNoOlderThan(priceFeedId, maxAge)` — but note
   this requires the price to have been pushed on-chain recently, otherwise the
-  call will revert. See the [Pyth documentation](https://docs.pyth.network/price-feeds/use-real-time-data/evm) for more details on the pull model.
-</Callout>
+  call will revert.
+  See the [Pyth documentation](https://docs.pyth.network/price-feeds/use-real-time-data/evm)
+  for more details on the pull model.
+</Warning>