Make symbol parameter optional in GetFundingRatesAsync by DShaurin · Pull Request #1580 · JKorf/Binance.Net

DShaurin · 2026-04-28T09:19:43Z

Due to documentation symbol parameter is optional and GetFundingRatesAsync can return data for all symbols either.
Make symbol parameter nullable to support this behavior.

Due to https://developers.binance.com/docs/derivatives/usds-margined-futures/market-data/rest-api/Get-Funding-Rate-History symbol parameter is optional and GetFundingRatesAsync can return data for all symbols either

DShaurin · 2026-05-16T08:41:17Z

@JKorf do you have any doubts about this PR?

JKorf · 2026-05-22T08:12:30Z

Sorry I missed this one.
What data is returned if you don't provide a symbol? A one dimensional array seems odd for historical data for multiple symbols?

rxmp · 2026-06-10T10:40:58Z

@JKorf It is odd, but the API just returns a list of symbols that had their funding rate updated, sorted by oldest first within the limit.

In the example below HOMEUSDT has 2 occurrences with an hour difference.

Example for request with no parameters

[
    {
        "symbol": "TAGUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00105094"
    },
    {
        "symbol": "TAIKOUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.08379818"
    },
    {
        "symbol": "TAKEUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.01735710"
    },
    {
        "symbol": "TAOUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "206.56000000"
    },
    {
        "symbol": "TAUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00008785",
        "markPrice": "0.07314350"
    },
    {
        "symbol": "THETAUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00001507",
        "markPrice": "0.15005000"
    },
    {
        "symbol": "THEUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.06562000"
    },
    {
        "symbol": "TIAUSDC",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.31951093"
    },
    {
        "symbol": "TIAUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00002447",
        "markPrice": "0.31980000"
    },
    {
        "symbol": "TLMUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00099000"
    },
    {
        "symbol": "TNSRUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.02826000"
    },
    {
        "symbol": "TONUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00003247",
        "markPrice": "1.66352691"
    },
    {
        "symbol": "TOSHIUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00011925"
    },
    {
        "symbol": "TOWNSUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00222800"
    },
    {
        "symbol": "TRADOORUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.37522000"
    },
    {
        "symbol": "TRBUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "12.97849291"
    },
    {
        "symbol": "TREEUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.04439000"
    },
    {
        "symbol": "TRIAUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.02609365"
    },
    {
        "symbol": "TRUMPUSDC",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00005841",
        "markPrice": "1.64800000"
    },
    {
        "symbol": "TRUMPUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00018087",
        "markPrice": "1.65000000"
    },
    {
        "symbol": "TRUSTUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.04833000"
    },
    {
        "symbol": "TRUTHUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.01143800"
    },
    {
        "symbol": "TRXUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00026676",
        "markPrice": "0.32240586"
    },
    {
        "symbol": "TSTUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.01579900"
    },
    {
        "symbol": "TURBOUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00083913"
    },
    {
        "symbol": "TURTLEUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.03545000"
    },
    {
        "symbol": "TUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00369450"
    },
    {
        "symbol": "TUTUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00996000"
    },
    {
        "symbol": "TWTUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.37760000"
    },
    {
        "symbol": "UAIUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.33380000"
    },
    {
        "symbol": "UBUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.14950247"
    },
    {
        "symbol": "UMAUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.38540000"
    },
    {
        "symbol": "UNIUSDC",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00010000",
        "markPrice": "2.45952685"
    },
    {
        "symbol": "UNIUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00003208",
        "markPrice": "2.46300000"
    },
    {
        "symbol": "USDCUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00002053",
        "markPrice": "1.00001315"
    },
    {
        "symbol": "USELESSUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00008293",
        "markPrice": "0.06046786"
    },
    {
        "symbol": "USTCUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00609600"
    },
    {
        "symbol": "USUALUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00957000"
    },
    {
        "symbol": "USUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00016633",
        "markPrice": "0.01264276"
    },
    {
        "symbol": "VANAUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "1.09100000"
    },
    {
        "symbol": "VANRYUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00342100"
    },
    {
        "symbol": "VELODROMEUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.01362000"
    },
    {
        "symbol": "VELVETUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.39984591"
    },
    {
        "symbol": "VETUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00010000",
        "markPrice": "0.00477229"
    },
    {
        "symbol": "VICUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00007543",
        "markPrice": "0.03595420"
    },
    {
        "symbol": "VIRTUALUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00014018",
        "markPrice": "0.56340000"
    },
    {
        "symbol": "VTHOUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00038430"
    },
    {
        "symbol": "VVVUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00004670",
        "markPrice": "14.48796613"
    },
    {
        "symbol": "WALUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00030079",
        "markPrice": "0.03303000"
    },
    {
        "symbol": "WAXPUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00449500"
    },
    {
        "symbol": "WCTUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.04521000"
    },
    {
        "symbol": "WETUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.05503967"
    },
    {
        "symbol": "WIFUSDC",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.15231241"
    },
    {
        "symbol": "WIFUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00000846",
        "markPrice": "0.15261267"
    },
    {
        "symbol": "WLDUSDC",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00025906",
        "markPrice": "0.49940000"
    },
    {
        "symbol": "WLDUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00025509",
        "markPrice": "0.49960000"
    },
    {
        "symbol": "WLFIUSDC",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.05769000"
    },
    {
        "symbol": "WLFIUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.05778000"
    },
    {
        "symbol": "WOOUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00010000",
        "markPrice": "0.01284017"
    },
    {
        "symbol": "WUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00898499"
    },
    {
        "symbol": "XAIUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00776400"
    },
    {
        "symbol": "XANUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00768399"
    },
    {
        "symbol": "XAUTUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00000942",
        "markPrice": "4174.69000000"
    },
    {
        "symbol": "XLMUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00004326",
        "markPrice": "0.18605000"
    },
    {
        "symbol": "XMRUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00010000",
        "markPrice": "318.04607143"
    },
    {
        "symbol": "XNYUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00496878"
    },
    {
        "symbol": "XPINUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00114900"
    },
    {
        "symbol": "XPLUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00004542",
        "markPrice": "0.06488000"
    },
    {
        "symbol": "XRPUSDC",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00010000",
        "markPrice": "1.11560000"
    },
    {
        "symbol": "XRPUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00001337",
        "markPrice": "1.11610000"
    },
    {
        "symbol": "XTZUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00002886",
        "markPrice": "0.23480000"
    },
    {
        "symbol": "XVGUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00010000",
        "markPrice": "0.00244564"
    },
    {
        "symbol": "XVSUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00039605",
        "markPrice": "2.42000000"
    },
    {
        "symbol": "YBUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.08595112"
    },
    {
        "symbol": "YFIUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00009990",
        "markPrice": "1874.00000000"
    },
    {
        "symbol": "YGGUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.02512000"
    },
    {
        "symbol": "ZAMAUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.02933000"
    },
    {
        "symbol": "ZBTUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.13412000"
    },
    {
        "symbol": "ZECUSDC",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00035561",
        "markPrice": "432.13000000"
    },
    {
        "symbol": "ZECUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "-0.00077843",
        "markPrice": "432.51000000"
    },
    {
        "symbol": "ZENUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00007758",
        "markPrice": "4.34770833"
    },
    {
        "symbol": "ZEREBROUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.02653226"
    },
    {
        "symbol": "ZESTUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.26156203"
    },
    {
        "symbol": "ZETAUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.03501619"
    },
    {
        "symbol": "ZILUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00305834"
    },
    {
        "symbol": "ZKCUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.04818197"
    },
    {
        "symbol": "ZKPUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.05308867"
    },
    {
        "symbol": "ZKUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.01056056"
    },
    {
        "symbol": "ZORAUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.00810000"
    },
    {
        "symbol": "ZROUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00005000",
        "markPrice": "0.81989558"
    },
    {
        "symbol": "ZRXUSDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00002115",
        "markPrice": "0.08618435"
    },
    {
        "symbol": "币安人生USDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00031660",
        "markPrice": "0.70900000"
    },
    {
        "symbol": "我踏马来了USDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00040159",
        "markPrice": "0.00832000"
    },
    {
        "symbol": "龙虾USDT",
        "fundingTime": 1781078400011,
        "fundingRate": "0.00030953",
        "markPrice": "0.01066756"
    },
    {
        "symbol": "GUAUSDT",
        "fundingTime": 1781082000000,
        "fundingRate": "-0.00289983",
        "markPrice": "0.59439261"
    },
    {
        "symbol": "HOMEUSDT",
        "fundingTime": 1781082000000,
        "fundingRate": "-0.00120308",
        "markPrice": "0.03003000"
    },
    {
        "symbol": "HUSDT",
        "fundingTime": 1781082000000,
        "fundingRate": "-0.00046325",
        "markPrice": "0.08907282"
    },
    {
        "symbol": "GUAUSDT",
        "fundingTime": 1781085600005,
        "fundingRate": "-0.00227114",
        "markPrice": "0.60690000"
    },
    {
        "symbol": "HOMEUSDT",
        "fundingTime": 1781085600005,
        "fundingRate": "-0.00330247",
        "markPrice": "0.03103000"
    },
    {
        "symbol": "HUSDT",
        "fundingTime": 1781085600005,
        "fundingRate": "-0.00049745",
        "markPrice": "0.08551158"
    }
]

DShaurin · 2026-06-12T11:05:07Z

@JKorf you're right, the endpoint returns just an array of historical FundingRates with limit length for all exchange symbols like @rxmp said. Later user can create a Dictionary<string, BinanceFuturesFundingRateHistory> or so to make it more useful.
But this added optional symbol parameter makes it much easier to get "historical funding snapshot" of the whole market at a specific time range. With current implementation you have to call GetFundingRatesAsync for each of 600+ symbols to get the snapshot, that puts a strain on rate limits.

Make symbol parameter optional in GetFundingRatesAsync

e1997e5

Due to https://developers.binance.com/docs/derivatives/usds-margined-futures/market-data/rest-api/Get-Funding-Rate-History symbol parameter is optional and GetFundingRatesAsync can return data for all symbols either

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Make symbol parameter optional in GetFundingRatesAsync#1580

Make symbol parameter optional in GetFundingRatesAsync#1580
DShaurin wants to merge 1 commit into
JKorf:masterfrom
DShaurin:master

DShaurin commented Apr 28, 2026

Uh oh!

DShaurin commented May 16, 2026

Uh oh!

JKorf commented May 22, 2026

Uh oh!

rxmp commented Jun 10, 2026

Uh oh!

DShaurin commented Jun 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

DShaurin commented Apr 28, 2026

Uh oh!

DShaurin commented May 16, 2026

Uh oh!

JKorf commented May 22, 2026

Uh oh!

rxmp commented Jun 10, 2026

Uh oh!

DShaurin commented Jun 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants