> ## Documentation Index > Fetch the complete documentation index at: https://docs.blockworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Perpetual Market Funding Rate > One row per perpetual futures contract that reports a funding rate, across centralized exchanges and Hyperliquid, keyed by exchange and contract symbol: exchange, sub-venue, symbol, base asset and the contract's latest settlement interval. The id is the series key of the perpetual-market-funding-rates timeseries model, and matches the perpetual-markets id for the same contract. ## OpenAPI ````yaml api-reference/data-api/openapi.json GET /query/tabular/perpetual-market-funding-rates/{perpetualMarketID} openapi: 3.0.0 info: description: >- The Blockworks Data API is a unified, read-only REST interface to Blockworks' warehouse-modeled crypto dataset, powered by Messari's research and data infrastructure. It serves two kinds of models: tabular models, which return current, filterable, sortable rows for entities such as assets, networks, protocols, exchanges, stablecoins, and ETFs; and timeseries models, which return historical metric series at a chosen granularity for one or many entities. Every endpoint shares the same query grammar (column projection, per-column filters, sorting, and pagination) and returns the standard `{ "error": ..., "data": ... }` envelope. Authenticate by sending your API key in the `X-Blockworks-API-Key` header. title: Blockworks Data API version: 0.1.0 servers: - description: Blockworks API url: https://api.blockworks.com security: - apiKey: [] tags: - description: >- Models documented under Assets: Assets (table), Tokens (table), Asset Marketcap (timeseries), Asset Price (timeseries), Asset Sharpe (timeseries), Asset Supply (timeseries), Asset Volatility (timeseries). name: Assets - description: >- Models documented under Blockchains: Blockchains (table), Blockchains (timeseries). name: Blockchains - description: >- Models documented under Centralized Finance: CeFi Balances (table), CeFi Balances (timeseries). name: Centralized Finance - description: >- Models documented under Derivatives: Perpetual Market Funding Rates (table), Perpetual Markets (table), Perpetual Market Funding Rates (timeseries), Perpetual Markets (timeseries). name: Derivatives - description: >- Models documented under Digital Asset Treasury Companies: DAT Companies (table), DAT Company Assets (table), DAT Companies (timeseries), DAT Companies by Asset (timeseries). name: Digital Asset Treasury Companies - description: >- Models documented under ETFs: ETF Assets (table), ETF Providers (table), ETF Assets (timeseries), ETF Providers (timeseries). name: ETFs - description: >- Models documented under Exchanges: Exchange Country (timeseries), Exchange Region (timeseries), Exchange Type (timeseries), Exchanges (timeseries). name: Exchanges - description: >- Models documented under Fundraising: Acquisition Deals (table), Fund Managers (table), Funding Round Investors (table), Funding Rounds (table), Funds (table), Sector Fundraising (timeseries). name: Fundraising - description: >- Models documented under Launchpads: Launchpad Chains (table), Launchpads (table), Launchpads (timeseries), Launchpads by Chain (timeseries). name: Launchpads - description: >- Models documented under Lending Protocols: Lending Market Balances (table), Lending Market Financials (table), Lending Market Flows (table), Lending Market Interest Rates (table), Lending Market Liquidations (table), Lending Protocol Product Markets (table), Lending Protocol Products (table), Lending Protocols (table), Lending Market Balances (timeseries), Lending Market Financials (timeseries), Lending Market Flows (timeseries), Lending Market Interest Rates (timeseries), Lending Market Liquidations (timeseries), Lending Protocols (timeseries), Lending Protocols by Product (timeseries), Lending Protocols by Product Market (timeseries). name: Lending Protocols - description: >- Models documented under Markets: Markets (table), Market (BQEN) (timeseries). name: Markets - description: >- Models documented under Mindshare & Sentiment: Asset Group Sentiment (timeseries), Asset Investor Mentions (timeseries), Asset Mindshare (timeseries), Asset Sentiment (timeseries), Project Mindshare (timeseries), Sector Asset Mindshare (timeseries), Sector Asset Sentiment (timeseries), Sector Investor Mentions (timeseries), Sub-Sector Asset Mindshare (timeseries), Sub-Sector Asset Sentiment (timeseries). name: Mindshare & Sentiment - description: 'Models documented under News: News Feed (table), Topics (timeseries).' name: News - description: >- Models documented under Perp DEX Protocols: Perp DEX Protocols (table), Perp DEX Protocols (timeseries). name: Perp DEX Protocols - description: >- Models documented under Privacy: Privacy Flows and Balances (table), Privacy Flows and Balances (timeseries). name: Privacy - description: >- Models documented under Projects: Project Tokens (table), Project Tokens (timeseries), Projects (timeseries). name: Projects - description: >- Models documented under Protocol Revenue: Project Revenue (table), Project Tokenholder Distributions (table), Project Revenue (timeseries), Project Tokenholder Distributions (timeseries), Protocol Revenue (timeseries), Protocol Revenue by Product (timeseries). name: Protocol Revenue - description: >- Models documented under Real World Assets: RWA Categories (table), RWA Chains (table), RWA Deployments (table), RWA Issuers (table), RWA Products (table), RWA Spot DEX Segments (table), RWA by Category (timeseries), RWA by Chain (timeseries), RWA by Deployment (timeseries), RWA by Issuer (timeseries), RWA by Product (timeseries), RWA Spot DEX Activity (timeseries). name: Real World Assets - description: >- Models documented under Research Reports (Tabular): Research Reports (table). name: Research Reports (Tabular) - description: >- Models documented under Sector Market Data: Sector Marketdata (timeseries), Sub-Sector Marketdata (timeseries). name: Sector Market Data - description: >- Models documented under Spot DEX Protocols: Spot DEX Liquidity Balances (table), Spot DEX Protocol Chains (table), Spot DEX Protocols (table), Spot DEX Liquidity Balances (timeseries), Spot DEX Protocols (timeseries), Spot DEX Protocols by Chain (timeseries). name: Spot DEX Protocols - description: >- Models documented under Stablecoins: Stablecoin Chains (table), Stablecoin Currencies (table), Stablecoin FX Pairs (table), Stablecoin Issuers (table), Stablecoin Products (table), Stablecoin Reserve Entities (table), Stablecoin FX (timeseries), Stablecoin Reserves (timeseries), Stablecoins by Chain (timeseries), Stablecoins by Currency (timeseries), Stablecoins by Issuer (timeseries), Stablecoins by Product (timeseries). name: Stablecoins - description: >- Models documented under TCG Platforms: TCG Platform Chains (table), TCG Platforms by Chain (timeseries), TCG Platforms by Deployment (timeseries). name: TCG Platforms - description: >- Discovery of the tabular models: one row per entity, with per-column filters, sorting and pagination. name: Tabular - description: >- Discovery of the timeseries models: one series per entity, as points at the granularities each model declares. name: Timeseries - description: 'Models documented under Token Buybacks: Asset Buybacks (timeseries).' name: Token Buybacks - description: >- Models documented under Token Transparency: Token Transparency Filing Questions (table), Token Transparency Filing Schemas (table), Token Transparency Filings (table), Token Transparency Projects (table). name: Token Transparency - description: 'Models documented under Token Unlocks: Token Unlocks (timeseries).' name: Token Unlocks - description: >- Models documented under Tokenized Commodities: Tokenized Commodities (table), Tokenized Commodity Chains (table), Tokenized Commodity Issuers (table), Tokenized Commodity Products (table), Tokenized Commodities by Chain (timeseries), Tokenized Commodities by Commodity (timeseries), Tokenized Commodities by Issuer (timeseries), Tokenized Commodities by Product (timeseries). name: Tokenized Commodities - description: >- Models documented under Tokenized Equities: Tokenized Equities (table), Tokenized Equity Chains (table), Tokenized Equity Issuers (table), Tokenized Equity Products (table), Tokenized Equities by Chain (timeseries), Tokenized Equities by Equity (timeseries), Tokenized Equities by Issuer (timeseries), Tokenized Equities by Product (timeseries). name: Tokenized Equities - description: >- Models documented under Vaults: Vault Balances (table), Vault Chains (table), Vault Curators (table), Vault Financials (table), Vault Flows (table), Vault Performances (table), Vault Protocols (table), Vault Balances (timeseries), Vault Curators (timeseries), Vault Financials (timeseries), Vault Flows (timeseries), Vault Performances (timeseries), Vault Protocols (timeseries), Vaults by Chain (timeseries). name: Vaults paths: /query/tabular/perpetual-market-funding-rates/{perpetualMarketID}: get: tags: - Derivatives summary: Get Perpetual Market Funding Rate description: >- One row per perpetual futures contract that reports a funding rate, across centralized exchanges and Hyperliquid, keyed by exchange and contract symbol: exchange, sub-venue, symbol, base asset and the contract's latest settlement interval. The id is the series key of the perpetual-market-funding-rates timeseries model, and matches the perpetual-markets id for the same contract. operationId: getTabularRow_perpetual_market_funding_rates parameters: - description: The Perpetual Market ID identifying the row. in: path name: perpetualMarketID required: true schema: type: string - description: Comma-separated fields to return; defaults to all fields. in: query name: selections schema: items: enum: - perpetualMarketID - name - exchangeSlug - exchange - exchangeSub - symbol - baseAsset - baseAssetID - baseAssetName - baseAssetSlug - baseAssetSymbol - baseAssetSerialID - exchangeID - exchangeName - exchangeSerialID - intervalHours type: string type: array responses: '200': content: application/json: example: data: baseAsset: baseAssetID: baseAssetName: baseAssetSerialID: 123 baseAssetSlug: baseAssetSymbol: exchange: exchangeID: exchangeName: exchangeSerialID: 123 exchangeSlug: exchangeSub: intervalHours: 123 name: perpetualMarketID: symbol: error: null metadata: matchedField: perpetualMarketID schema: properties: data: $ref: '#/components/schemas/PerpetualMarketFundingRatesRow' error: nullable: true type: string metadata: description: >- The public field the lookup value matched on: the primary key or an alternative identifier. properties: matchedField: type: string required: - matchedField type: object required: - data - metadata type: object description: The matching row, and which field it matched on. '400': content: application/json: example: data: null error: unknown selection field "nope" schema: $ref: '#/components/schemas/ErrorResponse' description: >- The request is malformed: an unknown query parameter, or a selections field the model does not have. '401': content: application/json: example: data: null error: this model requires authentication schema: $ref: '#/components/schemas/ErrorResponse' description: No API key was sent and the model requires one. '403': content: application/json: example: data: null error: >- this model requires the "derivatives-dataset" permission; see https://app.blockworks.com/account/api for the public API permissions you hold schema: $ref: '#/components/schemas/ErrorResponse' description: >- The API key is not valid, or does not hold the "derivatives-dataset" permission. '404': content: application/json: example: data: null error: no row found matching "unknown" schema: $ref: '#/components/schemas/ErrorResponse' description: >- No row's Perpetual Market ID equals the path value, or the path names a model that does not exist. components: schemas: PerpetualMarketFundingRatesRow: properties: baseAsset: description: >- The ticker of the asset the contract tracks, parsed from the contract symbol with contract-size prefixes such as 1000 and k removed (1000PEPEUSDT and kPEPE both read PEPE). Set on every contract. To identify the asset, use baseAssetID, which matches perpetual-markets. nullable: true type: string baseAssetID: description: >- The unique identifier of the asset the contract tracks, the same as perpetual-markets for the same contract. Null, along with the other resolved base asset columns, where perpetual-markets has no asset for the contract. nullable: true type: string baseAssetName: description: The name of the asset the contract tracks. nullable: true type: string baseAssetSerialID: description: >- The numeric serial identifier of the base asset, used by market data services. Join on it to reach the spot markets for the same asset. format: int64 nullable: true type: integer baseAssetSlug: description: The URL slug of the asset the contract tracks. nullable: true type: string baseAssetSymbol: description: >- The ticker symbol of the asset the contract tracks, as the asset record holds it. It can differ in case and spelling from baseAsset. nullable: true type: string exchange: description: >- The exchange's short name as used in the id (binance, bybit, okx, hyperliquid). nullable: true type: string exchangeID: description: The unique identifier of the exchange. nullable: true type: string exchangeName: description: The display name of the exchange. nullable: true type: string exchangeSerialID: description: >- The numeric serial identifier of the exchange, used by market data services. format: int64 nullable: true type: integer exchangeSlug: description: >- The exchange's slug, shared by every market on that exchange (gate-io, crypto-com). nullable: true type: string exchangeSub: description: >- The venue within the exchange, where one exchange hosts several: 'main' on every centralized venue and on core Hyperliquid, the HIP-3 builder code (xyz, para) on a builder market. nullable: true type: string intervalHours: description: >- Hours between the contract's latest two settlements (1, 2, 4, 8 or 24). Null where neither neighbouring gap is one of those. format: int64 nullable: true type: integer name: description: >- The display name of the market, the exchange name followed by the contract symbol. nullable: true type: string perpetualMarketID: description: >- The series key of the perpetual-market-funding-rates timeseries model, the exchange and contract symbol joined with an underscore (binance_BTCUSDT). The same id as perpetual-markets where that model covers the contract. nullable: true type: string symbol: description: The exchange-native contract symbol. nullable: true type: string type: object ErrorResponse: properties: data: description: Always null on an error. nullable: true type: object error: description: What went wrong, in one sentence. type: string required: - error - data type: object securitySchemes: apiKey: description: >- API key sent in the `X-Blockworks-API-Key` header; `x-messari-api-key` is accepted for existing integrations. The catalog endpoints and models open to everyone need no key. in: header name: X-Blockworks-API-Key type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.