Skip to main content
GET
/
api
/
v1
/
market
/
funding_rate
/
{market_addr}
Get funding rate by market address
curl --request GET \
  --url https://api.ekiden.fi/api/v1/market/funding_rate/{market_addr}
{
  "funding_index": 1000000000000000000,
  "funding_interval_seconds": 28800,
  "funding_rate_percentage": 0.0001,
  "funding_rate_raw": 1000000000000000,
  "last_updated": "2024-01-01T12:00:00Z",
  "mark_price": 65000000000,
  "market_addr": "0x1234567890abcdef...",
  "next_funding_time": "2024-01-01T16:00:00Z",
  "oracle_price": 64950000000,
  "premium_rate_percentage": 0.0008,
  "symbol": "BTC-USD",
  "time_to_next_funding_seconds": 14400
}

Path Parameters

​
market_addr
string
required

Market address

Response

Successfully retrieved funding rate

​
funding_index
integer
required

Current funding index

Required range: x >= 0
Example:

1000000000000000000

​
funding_interval_seconds
integer
required

Funding interval in seconds

Required range: x >= 0
Example:

28800

​
funding_rate_percentage
number
required

Current funding rate as a percentage (e.g., 0.01 = 1%)

Example:

0.0001

​
funding_rate_raw
integer
required

Funding rate in raw format (scaled)

Example:

1000000000000000

​
last_updated
string<date-time>
required

Last updated timestamp

Example:

"2024-01-01T12:00:00Z"

​
mark_price
integer
required

Current mark price

Required range: x >= 0
Example:

65000000000

​
market_addr
string
required

Market address

Example:

"0x1234567890abcdef..."

​
next_funding_time
string<date-time>
required

Next funding time (timestamp)

Example:

"2024-01-01T16:00:00Z"

​
oracle_price
integer
required

Current oracle price

Required range: x >= 0
Example:

64950000000

​
premium_rate_percentage
number
required

Premium rate (mark - oracle) / oracle

Example:

0.0008

​
symbol
string
required

Market symbol

Example:

"BTC-USD"

​
time_to_next_funding_seconds
integer
required

Time until next funding in seconds

Required range: x >= 0
Example:

14400