# Quick Start Guide ## Requirements To access the Oracle Program examples, you will need to sign up for SEDA Fast. Get started with the SEDA Developer tier to start accessing SEDA with a free 7-day trial. Sign Up for SEDA Fast Key ## **Oracle Program Examples**
Session-Aware 24/5 US Equity Feed — powered by Pyth Data **Ticker**: NVDA **Session Tracking** Publicly listed equities typically follow three regular trading sessions, between 4:00am ET - 8:00pm ET. With SEDA, developers can access the Blue Ocean ADS overnight trading session provided exclusively in partnership with Pyth. The full 24/5 trading sessions are as follows: | Session name | Session timeframe (US Eastern Time) | | ------------- | ----------------------------------- | | Pre-market | 04:00am-09:30am | | Regular hours | 9:30am-04:00pm | | Post-market | 04:00pm-08:00pm | | Overnight | 08:00pm-04:00am+1 | To call this feed on SEDA Testnet, simply replace the BEARER\_TOKEN with your Fast API key, which should look like the following below: ``` Bearer fast_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \ ``` Copy the below POST execution, add your SEDA Fast API key, and paste the command into your terminal. 
curl -L -X POST 'https://fast-api.testnet.seda.xyz/execute?includeDebugInfo=true&encoding=json' \
-H 'Authorization: Bearer {{BEARER_TOKEN}}' \
-H 'Content-Type: application/json' \
--data-raw '{
    "execProgramId": "ad880830f3d6a46024715640b1ffd80a373f61008003aaefbbdded06cd27e5ad",
    "execInputs": {
        "session_ids": [
            "0x61c4ca5b9731a79e285a01e24432d57d89f0ecdd4cd7828196ca8992d5eafef6",
            "0xb1073854ed24cbc755dc527418f52b7d271f6cc967bbf8d8129112b18860a593",
            "0x25719379353a508b1531945f3c466759d6efd866f52fbaeb3631decb70ba381f",
            "0xc949a96fd1626e82abc5e1496e6e8d44683ac8ac288015ee90bf37257e3e6bf6"
        ],
        "weights": [100, 100, 100, 100]
    }
}'
You should get a response similar to the below: ``` { "_tag": "ExecuteResponse", "data": { "id": "d6e6123f-c853-40da-8780-432c36f60708", "requestId": "d6e6123f-c853-40da-8780-432c36f60708", "dataRequest": { "consensusFilter": "00", "execGasLimit": "300000000000000", "execInputs": "7b2273657373696f6e5f696473223a5b22307836316334636135623937333161373965323835613031653234343332643537643839663065636464346364373832383139366361383939326435656166656636222c22307862313037333835346564323463626337353564633532373431386635326237643237316636636339363762626638643831323931313262313838363061353933222c22307832353731393337393335336135303862313533313934356633633436363735396436656664383636663532666261656233363331646563623730626133383166222c22307863393439613936666431363236653832616263356531343936653665386434343638336163386163323838303135656539306266333732353765336536626636225d2c2277656967687473223a5b3130302c3130302c3130302c3130305d7d", "execProgramId": "ad880830f3d6a46024715640b1ffd80a373f61008003aaefbbdded06cd27e5ad", "gasPrice": "0", "memo": "", "replicationFactor": 1, "tallyGasLimit": "50000000000000", "tallyInputs": "", "tallyProgramId": "ad880830f3d6a46024715640b1ffd80a373f61008003aaefbbdded06cd27e5ad", "version": "0.0.1" } }, "dataResult": { "drId": "ba721f803efd8d767c8b9f4e6898478bb7681c11c9565b78156c221f823cbe8d", "gasUsed": "43337616905000", "blockHeight": "0", "blockTimestamp": "1772112795773", "consensus": true, "exitCode": 0, "version": "0.0.1", "result": "7b22636f6d706f736974655f72617465223a3139372e32303534392c227072696365223a7b226d616e7469737361223a223139373230353439222c226578706f223a2d357d2c226163746976655f73657373696f6e223a225052454d41524b4554222c2277656967687473223a7b2273657373696f6e223a312e302c227265666572656e6365223a302e307d2c2274696d657374616d70223a22323032362d30322d32365431333a33333a31352e3830395a222c22736f75726365735f75736564223a5b22687474703a2f2f707974682d747269746f6e2e70726f78792e746573746e65742e736564612e78797a2f70726f78792f76322f757064617465732f70726963652f6c61746573743f6964735b5d3d307836316334636135623937333161373965323835613031653234343332643537643839663065636464346364373832383139366361383939326435656166656636225d2c227761735f7374616c65223a66616c73657d", "paybackAddress": "", "sedaPayload": "" }, "signature": "9924380e314527724b3ce5375aa9c9f80df8153c16dd03cd599a14996f388bf57288129d11fb97043a6acfcd03e26b96566608af424c46694b64400e52b659ab00", "result": { "composite_rate": 197.20549, "price": { "mantissa": "19720549", "expo": -5 }, "active_session": "PREMARKET", "weights": { "session": 1, "reference": 0 }, "timestamp": "2026-02-26T13:33:15.809Z", "sources_used": [ "http://pyth-triton.proxy.testnet.seda.xyz/proxy/v2/updates/price/latest?ids[]=0x61c4ca5b9731a79e285a01e24432d57d89f0ecdd4cd7828196ca8992d5eafef6" ], "was_stale": false }, "execute": { "result": { "composite_rate": 197.20549, "price": { "mantissa": "19720549", "expo": -5 }, "active_session": "PREMARKET", "weights": { "session": 1, "reference": 0 }, "timestamp": "2026-02-26T13:33:15.809Z", "sources_used": [ "http://pyth-triton.proxy.testnet.seda.xyz/proxy/v2/updates/price/latest?ids[]=0x61c4ca5b9731a79e285a01e24432d57d89f0ecdd4cd7828196ca8992d5eafef6" ], "was_stale": false }, "gasUsed": "30961771856250", "stdout": "Session Aware Stock Market Execution Phase - Commit: 4cf6064be583d75464fa64a31f8c901278644c7f, Version: 1.0.1-rc.8\nSession: PreMarket, 2026-02-26T13:33:15.809+00:00\nFetching Pyth ID: 0x61c4ca5b9731a79e285a01e24432d57d89f0ecdd4cd7828196ca8992d5eafef6...\nUsing triton Pyth fetcher\nCHAIN_ID: Ok(\"seda-1-testnet\")\nPyth price data response: PythPriceResponse { parsed: [PythPriceParsedResponse { id: \"61c4ca5b9731a79e285a01e24432d57d89f0ecdd4cd7828196ca8992d5eafef6\", price: PriceData { price: \"19720549\", expo: -5, publish_time: 1772112794 } }] }\nSession is not stale\nCurrent session weight is 100, returning current session at 100% weight\n", "stderr": "", "exitCode": 0 }, "tally": { "result": { "composite_rate": 197.20549, "price": { "mantissa": "19720549", "expo": -5 }, "active_session": "PREMARKET", "weights": { "session": 1, "reference": 0 }, "timestamp": "2026-02-26T13:33:15.809Z", "sources_used": [ "http://pyth-triton.proxy.testnet.seda.xyz/proxy/v2/updates/price/latest?ids[]=0x61c4ca5b9731a79e285a01e24432d57d89f0ecdd4cd7828196ca8992d5eafef6" ], "was_stale": false }, "gasUsed": "12375845048750", "stdout": "Session Aware Stock Market Tally Phase - Commit: 4cf6064be583d75464fa64a31f8c901278644c7f, Version: 1.0.1-rc.8\n", "stderr": "", "exitCode": 0 } } ```
Metals Index — powered by Pyth Data **Ticker**: XAU/XAG/XPT/XPD basket (equal-weight default) ### Overview A configurable basket index of Gold, Silver, Platinum, and Palladium fetched via the **SEDA Pyth Proxy**. Returns standard **EVM uint256** output (hex-encoded) for on-chain use. Add `output_format: "json"` to exec inputs for human-readable `{"index": 2370.36}` when needed. | Metal | Default Weight | Pyth Feed ID | | --------------- | -------------- | -------------------------------------------------------------------- | | Gold (XAU) | 25% | `0x765d2ba906dbc32ca17cc11f5310a89e9ee1f6420508c63861f2f8ba4ee34bb2` | | Silver (XAG) | 25% | `0xf2fb02c32b055c805e7238d628e5e9dadef274376114eb1f012337cabe93871e` | | Platinum (XPT) | 25% | `0x398e4bbc7cbf89d6648c21e08019d878967677753b3096799595c78f805a34e5` | | Palladium (XPD) | 25% | `0x80367e9664197f37d89a07a804dffd2101c479c7c4e8490501bc9d9e1e7f9021` | ### Setup Replace `{{BEARER_TOKEN}}` with your SEDA Fast API key (e.g. `Bearer fast_test_xxxxxxxx...`). ### Example: Default (EVM uint256) Returns index × 10^8 as hex-encoded uint256 for smart contracts. **Equal weights (25% each):** ```bash curl -L -X POST 'https://fast-api.testnet.seda.xyz/execute?includeDebugInfo=true&encoding=json' \ -H 'Authorization: Bearer {{BEARER_TOKEN}}' \ -H 'Content-Type: application/json' \ --data-raw '{ "execProgramId": "6c28a47612cd475b47d19212495a694d308cf60e4d5b2b77be01dccd7a634ba5", "execInputs": {} }' ``` **Response (hex default):** `data.dataResult.result` is the EVM uint256 (hex). Divide by 10^8 for index in USD. ```json { "data": { "dataResult": { "consensus": true, "result": "000000000000000000000000000000000000000000000000000000373072b4a8" } } } ``` Example: `0x373072b4a8` = 237036025000 → **$2,370.36** (÷ 10^8). ### Example: Custom weights + human-readable (optional) Add `output_format: "json"` for API use. Override weights via `execInputs`: ```bash curl -L -X POST 'https://fast-api.testnet.seda.xyz/execute?includeDebugInfo=true&encoding=json' \ -H 'Authorization: Bearer {{BEARER_TOKEN}}' \ -H 'Content-Type: application/json' \ --data-raw '{ "execProgramId": "6c28a47612cd475b47d19212495a694d308cf60e4d5b2b77be01dccd7a634ba5", "execInputs": { "weights": { "gold": 40, "silver": 30, "platinum": 20, "palladium": 10 }, "output_format": "json" } }' ``` **Response (json):** ```json { "data": { "result": { "index": 2372.07651749 }, "dataResult": { "consensus": true } } } ``` ### Exec Inputs | Field | Default | Description | | --------------- | ------------------------------------------------------- | -------------------------------------------------------------------- | | `weights` | `{ gold: 25, silver: 25, platinum: 25, palladium: 25 }` | Weights must sum to 100 | | `output_format` | *(none)* | Omit for EVM uint256; use `"json"` for human-readable `{"index": x}` |
Simple Crypto Price Feed — powered by Pyth Data **Ticker**: ETH/USD (and 500+ crypto pairs) ### Overview Fetch crypto prices from Pyth via the SEDA Pyth Proxy. Uses standard **EVM uint256** output (hex-encoded) for on-chain and dApp use. Add `output_format: "json"` to exec inputs for human-readable `{"price": 1957.75}` when needed. ### Finding Asset IDs Crypto price feeds are identified by a 64-character hex Price Feed ID. Use the [Pyth Price Feeds explorer](https://insights.pyth.network/price-feeds?assetClass=Crypto) to search for your ticker, expand the asset row, and copy the full **Price Feed ID**. | Crypto pair | Price Feed ID | | ----------- | -------------------------------------------------------------------- | | BTC/USD | `0xe62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43` | | ETH/USD | `0xff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace` | Browse more at [Pyth Crypto Price Feeds](https://insights.pyth.network/price-feeds?assetClass=Crypto). ### Setup Replace `{{BEARER_TOKEN}}` with your SEDA Fast API key (e.g. `Bearer fast_test_xxxxxxxx...`). ### Example: Default (EVM uint256) Returns price × 10^8 as hex-encoded uint256 for smart contracts. ```bash curl -L -X POST 'https://fast-api.testnet.seda.xyz/execute?includeDebugInfo=true&encoding=json' \ -H 'Authorization: Bearer {{BEARER_TOKEN}}' \ -H 'Content-Type: application/json' \ --data-raw '{ "execProgramId": "1b7754932d711916abe9b986c4ac9c2195e7a9efbe7445d774739966370f880a", "execInputs": { "id": "0xff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace" } }' ``` **Response (hex default):** `data.dataResult.result` is the EVM uint256 (hex). Divide by 10^8 for USD price. ```json { "data": { "dataResult": { "consensus": true, "result": "0000000000000000000000000000000000000000000000000000002d9859a7cf" } } } ``` Example: `0x2d9859a7cf` = 195829540815 → **$1,958.30** (÷ 10^8). ### Example: Human-readable (optional) Add `output_format: "json"` for API use: ```bash curl -L -X POST 'https://fast-api.testnet.seda.xyz/execute?includeDebugInfo=true&encoding=json' \ -H 'Authorization: Bearer {{BEARER_TOKEN}}' \ -H 'Content-Type: application/json' \ --data-raw '{ "execProgramId": "1b7754932d711916abe9b986c4ac9c2195e7a9efbe7445d774739966370f880a", "execInputs": { "id": "0xff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace", "output_format": "json" } }' ``` **Response (json):** ```json { "data": { "result": { "price": 1957.74973229 }, "dataResult": { "consensus": true } } } ``` ### Exec Inputs | Field | Default | Description | | --------------- | -------- | -------------------------------------------------------------------- | | `id` | — | Pyth feed ID (hex, 64 chars, with or without 0x) | | `output_format` | *(none)* | Omit for EVM uint256; use `"json"` for human-readable `{"price": x}` |
## Troubleshooting and Further Documentation {% content-ref url="define-your-delivery-method/seda-fast/what-is-seda-fast" %} [what-is-seda-fast](https://docs.seda.xyz/home/for-developers/define-your-delivery-method/seda-fast/what-is-seda-fast) {% endcontent-ref %} {% content-ref url="define-your-delivery-method/seda-fast/getting-started" %} [getting-started](https://docs.seda.xyz/home/for-developers/define-your-delivery-method/seda-fast/getting-started) {% endcontent-ref %} {% content-ref url="define-your-delivery-method/seda-fast/api-reference" %} [api-reference](https://docs.seda.xyz/home/for-developers/define-your-delivery-method/seda-fast/api-reference) {% endcontent-ref %} {% content-ref url="define-your-delivery-method/seda-fast/advanced-usage" %} [advanced-usage](https://docs.seda.xyz/home/for-developers/define-your-delivery-method/seda-fast/advanced-usage) {% endcontent-ref %}