REST API

Real-Time and historical Data API for Stork signed data.

Authentication

All REST requests must include an Authorization header with the value set as Basic <token> . For example if your token is gmork123:

curl -x GET 'https://api.jp.stork-oracle.network/priced/assets' -H "Authorization: Basic gmork123"

Rate Limits

There is currently a universal rate limit of 5 requests/sec.

Need a higher rate limit? Reach out to Stork. [email protected] or Twitter DMs open.

List Available Assets

get

Get the list of availble asset IDs.

Authorizations

Responses

200

OK

application/json

404

Not Found

get

HTTPcURLJavaScriptPython

GET /v1/prices/assets HTTP/1.1
Host: rest.jp.stork-oracle.network
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": [
    "BTCUSD"
  ]
}

Get Latest Prices

get

Get latest real-time prices for specified assets.

Authorizations

Query parameters

assetsstringRequired

Comma-separated list of asset symbols (e.g., BTCUSD)

Responses

200

OK

application/json

400

Bad Request

application/json

get

HTTPcURLJavaScriptPython

GET /v1/prices/latest HTTP/1.1
Host: rest.jp.stork-oracle.network
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "timestamp": 1734127259251174100,
      "asset_id": "BTCUSD",
      "signature_type": "evm",
      "trigger": "unspecified",
      "price": "101344782928537490000000",
      "stork_signed_price": {
        "public_key": "0x0a803F9b1CCe32e2773e0d2e98b37E0775cA5d44",
        "encoded_asset_id": "0x7404e3d104ea7841c3d9e6fd20adfe99b4ad586bc08d8f3bd3afef894cf184de",
        "price": "101344782928537490000000",
        "timestamped_signature": {
          "signature": {
            "r": "0xb193e9ff3e3c0346ca74e194b8eab13cc9d49b73a68167b7a021ec979cb3aef7",
            "s": "0x07a7176c245e24777755ae3037450862bb4dbc1e4ff49304cd82c3d818a8e598",
            "v": "0x1b"
          },
          "timestamp": 1734127259251174100,
          "msg_hash": "0x977891628f4fc326f858ec33ba03da335e2ec4648a9f9332ab0317a64165fa7c"
        },
        "publisher_merkle_root": "0x4e0a03960cea21f67d7f2b66c5457fa4fea3632a68d0f3bc01adb0588446efdf",
        "calculation_alg": {
          "type": "median",
          "version": "v1",
          "checksum": "9be7e9f9ed459417d96112a7467bd0b27575a2c7847195c68f805b70ce1795ba"
        }
      },
      "signed_prices": [
        {
          "publisher_key": "0x51aa9e9C781F85a2C0636A835EB80114c4553098",
          "external_asset_id": "BTCUSD",
          "signature_type": "evm",
          "price": "101344782928537490000000",
          "timestamped_signature": {
            "signature": {
              "r": "0xb193e9ff3e3c0346ca74e194b8eab13cc9d49b73a68167b7a021ec979cb3aef7",
              "s": "0x07a7176c245e24777755ae3037450862bb4dbc1e4ff49304cd82c3d818a8e598",
              "v": "0x1b"
            },
            "timestamp": 1734127259251174100,
            "msg_hash": "0x977891628f4fc326f858ec33ba03da335e2ec4648a9f9332ab0317a64165fa7c"
          },
          "metadata": null
        }
      ]
    }
  ]
}

Get Historical Price Metrics

get

Get OHLC price data for a specific asset within a time range.

Authorizations

Query parameters

fromintegerRequired

Start timestamp (Unix seconds)

tointegerRequired

Start timestamp (Unix seconds)

resolutionstring · enumRequired

Time resolution in minutes, or 1 day, 1 week, or 1 month.

Possible values:

symbolstringRequired

A unique identifier for an asset.

Example: BTCUSD

Responses

200

successful operation

get

HTTPcURLJavaScriptPython

GET /v1/tradingview/history HTTP/1.1
Host: rest.jp.stork-oracle.network
Authorization: YOUR_API_KEY
Accept: */*

200

successful operation

No content