search
Support

Quick Start Guide

This guide is for developers that would like to immediately start testing existing examples of Oracle Programs with SEDA Fast.

hashtag
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

hashtag
Oracle Program Examples

chevron-rightSession-Aware 24/5 US Equity Feed — powered by Pyth Datahashtag

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
  }
}
chevron-rightMetals Index — powered by Pyth Datahashtag

Ticker: XAU/XAG/XPT/XPD basket (equal-weight default)

hashtag
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

hashtag
Setup

Replace {{BEARER_TOKEN}} with your SEDA Fast API key (e.g. Bearer fast_test_xxxxxxxx...).

hashtag
Example: Default (EVM uint256)

Returns index × 10^8 as hex-encoded uint256 for smart contracts.

Equal weights (25% each):

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.

{
  "data": {
    "dataResult": {
      "consensus": true,
      "result": "000000000000000000000000000000000000000000000000000000373072b4a8"
    }
  }
}

Example: 0x373072b4a8 = 237036025000 → $2,370.36 (÷ 10^8).

hashtag
Example: Custom weights + human-readable (optional)

Add output_format: "json" for API use. Override weights via execInputs:

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):

{
  "data": {
    "result": {
      "index": 2372.07651749
    },
    "dataResult": {
      "consensus": true
    }
  }
}

hashtag
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}

chevron-rightSimple Crypto Price Feed — powered by Pyth Datahashtag

Ticker: ETH/USD (and 500+ crypto pairs)

hashtag
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.

hashtag
Finding Asset IDs

Crypto price feeds are identified by a 64-character hex Price Feed ID. Use the Pyth Price Feeds explorerarrow-up-right 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 Feedsarrow-up-right.

hashtag
Setup

Replace {{BEARER_TOKEN}} with your SEDA Fast API key (e.g. Bearer fast_test_xxxxxxxx...).

hashtag
Example: Default (EVM uint256)

Returns price × 10^8 as hex-encoded uint256 for smart contracts.

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.

{
  "data": {
    "dataResult": {
      "consensus": true,
      "result": "0000000000000000000000000000000000000000000000000000002d9859a7cf"
    }
  }
}

Example: 0x2d9859a7cf = 195829540815 → $1,958.30 (÷ 10^8).

hashtag
Example: Human-readable (optional)

Add output_format: "json" for API use:

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):

{
  "data": {
    "result": {
      "price": 1957.74973229
    },
    "dataResult": {
      "consensus": true
    }
  }
}

hashtag
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}

hashtag
Troubleshooting and Further Documentation

What is SEDA Fast?chevron-rightGetting Startedchevron-rightAPI Referencechevron-rightAdvanced Usagechevron-right

PreviousSEDA Explorers and DashboardsNextDefine your Data Source

Last updated

Was this helpful?