Funding Rate Candle Series

Retrieve funding-rate candles for a selected exchange, trading pair and interval. Each observation contains a timestamp and open, high, low and close values in structured JSON.

What this Actor does

Prepare funding-rate charts and compare variation within historical intervals. These candles describe funding rates, not asset trading prices.

Input

Field	Type	Required	Description
exchange	string	Yes	Exchange selector. The verified example uses Binance.
symbol	string	Yes	Trading-pair symbol. The verified example uses BTCUSDT.
interval	string	Yes	Historical interval. The verified example uses 1h; preserve letter case.
endTime	string	Yes	End timestamp in Unix milliseconds, supplied as a string. The example is a fixed historical time, not a request for the latest data.
size	string	Yes	Requested history size, supplied as a string. The verified example uses 10; returned coverage and grouping may affect the number of rows.

Example input

{
  "endTime": "1789544653329",
  "exchange": "Binance",
  "interval": "1h",
  "size": "10",
  "symbol": "BTCUSDT"
}

Use the verified example to understand the input structure. Update the time and selectors for your query. Supported market coverage depends on the selected parameters; unsupported combinations can return empty data or errors.

Output

The response includes code, success and data. Observed entries contain begin, open, high, low and close. begin is a millisecond timestamp. Rate values are retained as returned, without conversion to asset prices.

Example output

This is an abbreviated historical response, not a current market quote. Additional rows and fields may be present.

{
  "code": "1",
  "success": true,
  "data": [
    {
      "begin": 1789509600000,
      "close": 0.004977,
      "high": 0.005408,
      "low": 0.004719,
      "open": 0.005408
    }
  ]
}

A successful run saves its JSON result under OUTPUT and in the default dataset. Open the Output tab to inspect the result and timestamps.

Pricing

One request event is $0.05. Review the current Pricing panel and set a maximum run charge that covers the listed event. Check any platform usage displayed before starting.

How to run

1. Review the input and historical example.
2. Confirm the current price and run budget.
3. Start one run and wait for its final status.
4. Open Output and inspect the response status, timestamps and available fields.

Scope and troubleshooting

Each run performs one data query. Data availability and freshness vary by market and query parameters. This Actor does not execute trades, move funds or maintain a live subscription.

If a run fails, retain its Run ID and inspect the status and log. Review the input before starting another run. For support, open an Actor Issue with the Run ID and sanitized input; omit credentials and private keys. Financial data is informational, not investment advice.