Execute On SEDA Fast

Execute Oracle Programs through SEDA Fast (API-first). Includes canonical curl examples and links to Fast OpenAPI docs.

Execute via SEDA Fast (API)

Canonical URL: https://docs.seda.xyz/home/for-agents/agent-modules/execute-on-seda-fast Source file: modules/40-execute-fast.md

Important: SEDA Fast does not deploy Oracle Programs.

• Deploy (upload) Oracle Programs to the SEDA Network using a wallet + tokens (testnet or mainnet).

• Execute Oracle Programs via SEDA Fast using an API key and the existing Oracle Program ID.

If you do not have an Oracle Program ID yet, go to: modules/50-execute-core.md (Deploy section) + modules/30-wallet-and-tokens.md.

Authoritative references:

• Quick Start Guide: https://docs.seda.xyz/home/for-developers/quick-start-guide

• SEDA Fast overview: https://docs.seda.xyz/home/for-developers/define-your-delivery-method/seda-fast

• Fast API reference (OpenAPI):

  • Testnet: https://fast-api.testnet.seda.xyz/docs

  • Mainnet: https://fast-api.mainnet.seda.xyz/docs

This runbook executes Oracle Programs through the SEDA Fast API.

Rule: Do not guess payload shapes or fields. If anything changes, treat the OpenAPI docs as the source of truth.

---

Critical distinction (Fast execution vs Program deployment)

Case 1: Execute an existing Oracle Program on Fast

• Needs: Fast API key

• Does not need: wallet/tokens

Case 2: Deploy your own Oracle Program, then execute on Fast

• Needs: wallet + tokens to deploy the Oracle Program

  • modules/30-wallet-and-tokens.md

  • deploy step in modules/50-execute-core.md

• Needs: Fast API key to execute

---

Canonical execute endpoint (testnet)

Docs use: https://fast-api.testnet.seda.xyz/execute?includeDebugInfo=true&encoding=json

---

Example: ETH/USD (JSON output)

Copy/paste (replace the bearer token only):

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"
    }
  }'

Checkpoint:

• response JSON includes a result object and a top-level signature

• response indicates successful execution (e.g., consensus info / debug info)

---

Using your own Oracle Program on Fast

Prerequisite:

• you must already have an oracleProgramId from deployment (Core deploy step)

Action:

• set:

  • execProgramId = <your oracleProgramId>

  • execInputs = <your program’s input schema>

Checkpoint:

• you can specify execInputs exactly (no guessing)

• the response includes result + signature

---

Execute on SEDA Fast (mainnet)

Use this when you are ready to execute against Fast mainnet.

Source of truth (OpenAPI):

• https://fast-api.mainnet.seda.xyz/docs

Canonical execute endpoint (mainnet)

Use the same path/query params as testnet, but with the mainnet host:

https://fast-api.mainnet.seda.xyz/execute?includeDebugInfo=true&encoding=json

Example: ETH/USD (JSON output) — mainnet

Copy/paste (replace the bearer token only):

curl -L -X POST 'https://fast-api.mainnet.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"
    }
  }'

Checkpoint:

• response includes result + signature

• if you receive auth errors, confirm you are using a mainnet Fast API key