---
title: "One symbol's funding on every venue, with history"
method: GET
path: "/api/markets/funding-rates/{slug}"
tags: ["Crypto"]
---

# One symbol's funding on every venue, with history

`GET /api/markets/funding-rates/{slug}`

## Request

- Base URL: `https://xoomar.com`
- URL: `https://xoomar.com/api/markets/funding-rates/{slug}`
- Auth: one of:
  - none
  - API key in header `x-api-key`

The current rate on every venue; with history, up to 5,000 settled rates across venues, newest first. Docs: https://xoomar.com/markets/api/funding-rates

## Path parameters

- `slug` string, required

## Query parameters

- `history` '30d' | '1y' | 'all'

## Response `200`

OK

- object
  - `data` object
    - `slug` string: Symbol slug used in URLs (btc, eth, sol...)
    - `baseAsset` string: Base asset ticker (BTC, ETH...)
    - `exchange` string: binance, bybit, okx, hyperliquid or kraken
    - `markPrice` string, nullable: Latest mark price in USD
    - `fundingRate` string, nullable: Current funding rate as published, a decimal per settlement interval (0.0001 = 0.01% per interval)
    - `fundingIntervalHours` number: Hours per settlement: 8 (Binance, Bybit, OKX) or 1 (Hyperliquid, Kraken)
    - `fundingRate8h` number, nullable: The rate scaled to eight hours, comparable across venues
    - `fundingAnnualized` number, nullable: Annualized rate, simple (not compounded), from the rate and its funding interval
    - `nextFundingTime` string, nullable: ISO timestamp of the next funding settlement
    - `openInterest` string, nullable: Open interest in contracts
    - `openInterestValue` string, nullable: Open interest notional in USD
    - `priceChangePct24h` string, nullable: 24h price change as a decimal
    - `longShortRatio` string, nullable: Global long/short account ratio where the venue publishes it, else null
    - `canonicalUrl` string, uri: The matching page on xoomar.com
  - `updatedAt` string, date-time: When the response was built; a few dated feeds give the date of their newest row instead
  - `source` 'xoomar.com'
  - `docs` string
  - `license` string: Data terms
  - `attribution` string
  - `canonicalUrl` string, uri: The matching page on xoomar.com
  - `meta` object: Who publishes the data and how to credit it
    - `source` string: The publisher or publishers of the data, comma-separated
    - `sourceAttribution` string: The credit line to show wherever the data is displayed
    - `notice` string: Requests without a key only: the free key, app registration and the credit

## Other responses

- `404`: Unknown slug, ticker or country
- `429`: Rate limit: 10 requests a minute without a key, 30 with a free key

---

[API](https://skmtc.dev/xoomar/apis/xoomar-market-data-api.md) · [All operations](https://skmtc.dev/xoomar/apis/xoomar-market-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xoomar/apis/xoomar-market-data-api/revisions/07b78401eaaa?raw)