# Quickstart ## 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}` |
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.seda.xyz/home/developer/getting-started/quickstart.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.