Execute a subscription round

curl --request POST \
  --url https://dev-gateway.molpha.io/v1/round/execute \
  --header 'Content-Type: application/json' \
  --data '
{
  "subscriptionOwner": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "consumerAuthority": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "signaturesRequired": 3,
  "timestamp": 1700100000,
  "registryVersion": 42,
  "authSig": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9ibyvq8CJ7qJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJq",
  "apiConfig": {
    "url": "https://api.example.com/v1/price",
    "method": "GET",
    "headers": {},
    "responseParser": "$.data.price",
    "valueTransform": "multiply:1e6"
  }
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    subscriptionOwner: '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
    consumerAuthority: '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
    signaturesRequired: 3,
    timestamp: 1700100000,
    registryVersion: 42,
    authSig: '5VERv8NMvzbJMEkV8xnrLkEaWRtSz9ibyvq8CJ7qJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJq',
    apiConfig: {
      url: 'https://api.example.com/v1/price',
      method: 'GET',
      headers: {},
      responseParser: '$.data.price',
      valueTransform: 'multiply:1e6'
    }
  })
};

fetch('https://dev-gateway.molpha.io/v1/round/execute', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://dev-gateway.molpha.io/v1/round/execute"

payload = {
    "subscriptionOwner": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "consumerAuthority": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "signaturesRequired": 3,
    "timestamp": 1700100000,
    "registryVersion": 42,
    "authSig": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9ibyvq8CJ7qJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJq",
    "apiConfig": {
        "url": "https://api.example.com/v1/price",
        "method": "GET",
        "headers": {},
        "responseParser": "$.data.price",
        "valueTransform": "multiply:1e6"
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://dev-gateway.molpha.io/v1/round/execute"

	payload := strings.NewReader("{\n  \"subscriptionOwner\": \"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU\",\n  \"consumerAuthority\": \"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU\",\n  \"signaturesRequired\": 3,\n  \"timestamp\": 1700100000,\n  \"registryVersion\": 42,\n  \"authSig\": \"5VERv8NMvzbJMEkV8xnrLkEaWRtSz9ibyvq8CJ7qJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJq\",\n  \"apiConfig\": {\n    \"url\": \"https://api.example.com/v1/price\",\n    \"method\": \"GET\",\n    \"headers\": {},\n    \"responseParser\": \"$.data.price\",\n    \"valueTransform\": \"multiply:1e6\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "status": "completed",
  "data": {
    "feedId": "0xabc123...",
    "value": "42150125000000",
    "valuePacked": "<string>",
    "timestamp": 1700100000,
    "registryVersion": 42,
    "signaturesRequired": 3,
    "configHash": "<string>",
    "signersBitmap": "<string>",
    "s": "<string>",
    "rx": "<string>",
    "ryParity": 123,
    "commitmentAddr": "<string>",
    "fresh": true
  }
}

{
  "error": "validation failed"
}

{
  "error": "validation failed"
}

{
  "error": "validation failed"
}

{
  "error": "validation failed"
}

{
  "error": "validation failed"
}

{
  "error": "validation failed"
}

POST

round

execute

Execute a subscription round

curl --request POST \
  --url https://dev-gateway.molpha.io/v1/round/execute \
  --header 'Content-Type: application/json' \
  --data '
{
  "subscriptionOwner": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "consumerAuthority": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "signaturesRequired": 3,
  "timestamp": 1700100000,
  "registryVersion": 42,
  "authSig": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9ibyvq8CJ7qJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJq",
  "apiConfig": {
    "url": "https://api.example.com/v1/price",
    "method": "GET",
    "headers": {},
    "responseParser": "$.data.price",
    "valueTransform": "multiply:1e6"
  }
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    subscriptionOwner: '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
    consumerAuthority: '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
    signaturesRequired: 3,
    timestamp: 1700100000,
    registryVersion: 42,
    authSig: '5VERv8NMvzbJMEkV8xnrLkEaWRtSz9ibyvq8CJ7qJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJq',
    apiConfig: {
      url: 'https://api.example.com/v1/price',
      method: 'GET',
      headers: {},
      responseParser: '$.data.price',
      valueTransform: 'multiply:1e6'
    }
  })
};

fetch('https://dev-gateway.molpha.io/v1/round/execute', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://dev-gateway.molpha.io/v1/round/execute"

payload = {
    "subscriptionOwner": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "consumerAuthority": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "signaturesRequired": 3,
    "timestamp": 1700100000,
    "registryVersion": 42,
    "authSig": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9ibyvq8CJ7qJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJq",
    "apiConfig": {
        "url": "https://api.example.com/v1/price",
        "method": "GET",
        "headers": {},
        "responseParser": "$.data.price",
        "valueTransform": "multiply:1e6"
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://dev-gateway.molpha.io/v1/round/execute"

	payload := strings.NewReader("{\n  \"subscriptionOwner\": \"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU\",\n  \"consumerAuthority\": \"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU\",\n  \"signaturesRequired\": 3,\n  \"timestamp\": 1700100000,\n  \"registryVersion\": 42,\n  \"authSig\": \"5VERv8NMvzbJMEkV8xnrLkEaWRtSz9ibyvq8CJ7qJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJqJq\",\n  \"apiConfig\": {\n    \"url\": \"https://api.example.com/v1/price\",\n    \"method\": \"GET\",\n    \"headers\": {},\n    \"responseParser\": \"$.data.price\",\n    \"valueTransform\": \"multiply:1e6\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "status": "completed",
  "data": {
    "feedId": "0xabc123...",
    "value": "42150125000000",
    "valuePacked": "<string>",
    "timestamp": 1700100000,
    "registryVersion": 42,
    "signaturesRequired": 3,
    "configHash": "<string>",
    "signersBitmap": "<string>",
    "s": "<string>",
    "rx": "<string>",
    "ryParity": 123,
    "commitmentAddr": "<string>",
    "fresh": true
  }
}

{
  "error": "validation failed"
}

{
  "error": "validation failed"
}

{
  "error": "validation failed"
}

{
  "error": "validation failed"
}

{
  "error": "validation failed"
}

{
  "error": "validation failed"
}

Body

application/json

Round execution request

Request body for POST /v1/round/execute.

subscriptionOwner

string

required

Subscription owner pubkey (base58). Equal to consumerAuthority for owner-direct requests.

Example:

"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"

consumerAuthority

string

required

Identity that signs RequestAuth and is used to derive feed_id (base58).

Example:

"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"

signaturesRequired

integer

required

Requested quorum, bounded by the subscription or delegate and current node count.

Example:

3

timestamp

integer

required

Unix timestamp (seconds) used as the on-chain replay key and in RequestAuth. Must be within the gateway clock skew window (default 300s).

Example:

1700100000

registryVersion

integer

required

Active on-chain registry version. Must match the current version.

Example:

42

authSig

string

required

Ed25519 signature (64 bytes, base58 or 0x hex) over: sha256("MOLPHA_REQAUTH_V1" || feed_id || uint64_le(timestamp)). Single-use per timestamp — recompute on every retry.

apiConfig

object

required

Off-chain HTTP API configuration hashed into the feed identity.

Hide child attributes

apiConfig.url

string

required

Target API URL. Must use http or https.

Example:

"https://api.example.com/v1/price"

apiConfig.responseParser

string

required

JSONPath expression to extract the value from the API response.

Example:

"$.data.price"

apiConfig.method

string

default:GET

HTTP method.

Example:

"GET"

apiConfig.headers

object

Request headers. Use {{secret.name}} placeholders with encKeyBundle for private APIs.

Hide child attributes

apiConfig.headers.{key}

string

Example:

{}

apiConfig.valueTransform

string

Optional post-parse transform (e.g. multiply:1e6).

Example:

"multiply:1e6"

encKeyBundle

object

Optional encryption envelope. Send null or omit for plaintext configs.

Hide child attributes

encKeyBundle.ephemeralPub

string

Ephemeral X25519 public key used to encrypt the config.

encKeyBundle.nonceSym

string

Symmetric encryption nonce.

encKeyBundle.ciphertext

string

Encrypted API configuration payload.

encKeyBundle.envelopes

object

Per-node encrypted key envelopes, keyed by node index.

Hide child attributes

encKeyBundle.envelopes.{key}

string

Response

Signed payload ready for submission or verification

Successful round response envelope shared by subscription and agent execute paths.

status

string

Round completion status.

Example:

"completed"

data

object

Threshold-signed oracle result included in successful round responses.

Hide child attributes

data.feedId

string

Derived feed identity (hex).

Example:

"0xabc123..."

data.value

string

Human-readable decoded value.

Example:

"42150125000000"

data.valuePacked

string

32-byte packed value (hex).

data.timestamp

integer

Canonical round timestamp (seconds).

Example:

1700100000

data.registryVersion

integer

Registry version active when the round was signed.

Example:

42

data.signaturesRequired

integer

Quorum required for this feed.

Example:

3

data.configHash

string

Hash of the committed API configuration.

data.signersBitmap

string

32-byte big-endian bitmap of participating signers (hex).

data.s

string

32-byte Schnorr scalar s (hex).

data.rx

string

Schnorr commitment x-coordinate (hex).

data.ryParity

integer

Schnorr commitment y parity (0 or 1).

data.commitmentAddr

string

20-byte commitment address (hex).

data.fresh

boolean

Always true for live gateway rounds.

Example:

true

Get Started

Quickstarts

AI Agents

Access Models

Core Concepts

Guides

Gateways

Verifiers

Protocol

Reference

Resources

Execute a subscription round

Body

Response