> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moralis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Current Price

> Get the current BTC price and additional market metadata.

export const EndpointMeta = ({premium, cus, cusUnit, mainnetOnly}) => {
  const items = [];
  const planName = typeof premium === "string" ? premium : "Pro";
  if (premium) {
    items.push({
      icon: "\u26a0\ufe0f",
      label: "Premium endpoint",
      text: <>
          Requires the <strong>{planName} plan</strong> or above.{" "}
          <a href="/data-api/introduction/resources/premium-endpoints">
            View all
          </a>
          .
        </>
    });
  }
  if (cus) {
    const isDynamic = !!cusUnit;
    items.push({
      icon: "\u26a1",
      label: isDynamic ? "Dynamic cost" : "Endpoint cost",
      text: isDynamic ? <>
          {cus} CUs per {cusUnit}.{" "}
          <a href="/get-started/pricing#dynamic-endpoints">Learn more</a>.
        </> : <>
          {cus} CUs.{" "}
          <a href="/get-started/pricing">Learn more</a>.
        </>
    });
  }
  if (mainnetOnly) {
    items.push({
      icon: "\ud83d\udd17",
      label: "Mainnet only",
      text: <>Testnet chains are not supported.</>
    });
  }
  if (items.length === 0) return null;
  return <div className="endpoint-meta" style={{
    border: "1px solid var(--border-color, #e2e8f0)",
    borderRadius: "8px",
    overflow: "hidden",
    marginBottom: "16px",
    fontSize: "14px",
    lineHeight: "1.6",
    maxWidth: "100%"
  }}>
      <style dangerouslySetInnerHTML={{
    __html: `
            .endpoint-meta {
              --border-color: #e2e8f0;
              --row-bg: #f8fafc;
              --label-color: #0f172a;
              --text-color: #1f2937;
            }
            .endpoint-meta a {
              color: #0f7fff !important;
              text-decoration: underline;
            }
            @media (prefers-color-scheme: dark) {
              .endpoint-meta {
                --border-color: #374151 !important;
                --row-bg: #1e293b !important;
                --label-color: #f9fafb !important;
                --text-color: #e5e7eb !important;
              }
              .endpoint-meta a {
                color: #60a5fa !important;
              }
            }
            html.dark .endpoint-meta,
            [data-theme="dark"] .endpoint-meta {
              --border-color: #374151 !important;
              --row-bg: #1e293b !important;
              --label-color: #f9fafb !important;
              --text-color: #e5e7eb !important;
            }
            html.dark .endpoint-meta a,
            [data-theme="dark"] .endpoint-meta a {
              color: #60a5fa !important;
            }
          `
  }} />
      {items.map((item, i) => <div key={i} style={{
    display: "flex",
    alignItems: "baseline",
    gap: "8px",
    padding: "10px 14px",
    borderBottom: i < items.length - 1 ? "1px solid var(--border-color, #e2e8f0)" : "none",
    backgroundColor: "var(--row-bg, #f8fafc)"
  }}>
          <span style={{
    flexShrink: 0
  }}>{item.icon}</span>
          <span style={{
    wordBreak: "break-word",
    color: "var(--text-color, #1f2937)"
  }}>
            <strong style={{
    color: "var(--label-color, #0f172a)"
  }}>
              {item.label}:
            </strong>{" "}
            {item.text}
          </span>
        </div>)}
    </div>;
};

<EndpointMeta cus={50} />

<Note>
  For BTC, pass `bitcoin` as `chainAlias` and `native` as `tokenAliasOrTokenAddress`.
</Note>


## OpenAPI

````yaml /openapi-files/data-api/bitcoin-api-v1.json GET /v1/chains/{chainAlias}/tokens/{tokenAliasOrTokenAddress}/price
openapi: 3.0.0
info:
  title: Moralis Bitcoin Data API
  description: >-
    Bitcoin-scoped view of the Moralis Universal API. Every endpoint below is a
    Universal endpoint with chain inputs restricted to Bitcoin for clarity.
  version: '1.0'
servers:
  - url: https://api.moralis.com
security: []
externalDocs:
  description: Moralis API Docs
  url: https://docs.moralis.com
paths:
  /v1/chains/{chainAlias}/tokens/{tokenAliasOrTokenAddress}/price:
    get:
      tags:
        - Tokens
      summary: Get the current BTC price
      description: Get the current BTC price and additional market metadata.
      operationId: getTokenPrice
      parameters:
        - name: chainAlias
          required: true
          in: path
          description: Bitcoin chain alias. Pass `bitcoin` or `bitcoin-mainnet`.
          schema:
            type: string
            enum:
              - bitcoin
              - bitcoin-mainnet
        - name: tokenAliasOrTokenAddress
          required: true
          in: path
          description: For BTC price, pass `native`.
          examples:
            btcNative:
              value: native
          schema:
            type: string
            enum:
              - native
        - name: toBlock
          required: false
          in: query
          description: Block number to check the price from
          schema:
            type: number
        - name: maxTokenInactivity
          required: false
          in: query
          description: Exclude tokens inactive for more than the specified days
          schema:
            type: number
        - name: liquidityThreshold
          required: false
          in: query
          description: Minimum liquidity in USD
          schema:
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTokenPriceResponseDto'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    GetTokenPriceResponseDto:
      type: object
      properties:
        chain:
          type: string
          description: The chain alias
          example: eth
        tokenName:
          type: string
          description: The token name
          example: Pepe
        tokenSymbol:
          type: string
          description: The token symbol
          example: PEPE
        tokenAddress:
          type: string
          description: The token contract address
          example: '0x6982508145454ce325ddbe47a25d4ec3d2311933'
          nullable: true
        tokenLogo:
          type: string
          description: The token logo URL
          nullable: true
          example: >-
            https://logo.moralis.io/0x1_0x69825081454ce6d19f71c224cba025989229.jpeg
        tokenDecimals:
          type: number
          description: The token decimals
          example: 18
        usdPrice:
          type: number
          description: The USD price
          example: 2534.12
        24hrChangeUsd:
          type: number
          description: The 24hr USD price change
          example: 35.82
        24hrChangePercent:
          type: number
          description: The 24hr price percent change
          example: 1.43
        nativePrice:
          description: The native price information
          allOf:
            - $ref: '#/components/schemas/NativePriceDto'
        verifiedContract:
          type: boolean
          description: Whether the contract is verified
          example: true
        securityScore:
          type: number
          description: The security score
          example: 99
        possibleSpam:
          type: boolean
          description: Whether the token is possibly spam
          example: false
        updatedAt:
          description: Information about when the price was last updated
          allOf:
            - $ref: '#/components/schemas/UpdatedAtDto'
        dexInformation:
          description: DEX exchange and pair information (null for Bitcoin)
          nullable: true
          allOf:
            - $ref: '#/components/schemas/DexInformationDto'
        meta:
          $ref: '#/components/schemas/SingleChainResponseMetaDto'
      required:
        - chain
        - tokenName
        - tokenSymbol
        - tokenAddress
        - tokenLogo
        - tokenDecimals
        - usdPrice
        - 24hrChangeUsd
        - 24hrChangePercent
        - nativePrice
        - verifiedContract
        - securityScore
        - possibleSpam
        - updatedAt
        - dexInformation
        - meta
    NativePriceDto:
      type: object
      properties:
        value:
          type: string
          description: The formatted native price value
          example: 439,425,812.15
        valueRaw:
          type: string
          description: The raw native price value (unformatted)
          example: '4394258121500000000'
        decimals:
          type: number
          description: The number of decimals
          example: 18
        name:
          type: string
          description: The name of the native token
          example: Ether
        symbol:
          type: string
          description: The symbol of the native token
          example: ETH
      required:
        - value
        - valueRaw
        - decimals
        - name
        - symbol
    UpdatedAtDto:
      type: object
      properties:
        timestamp:
          type: string
          description: The ISO 8601 timestamp of the last price update
          example: '2025-11-24T16:00:00.000Z'
        blockNumber:
          type: number
          description: The block number of the last price update
          example: 123456755
      required:
        - timestamp
        - blockNumber
    DexInformationDto:
      type: object
      properties:
        exchangeName:
          type: string
          description: The name of the exchange
          example: Uniswap v3
        exchangeAddress:
          type: string
          description: The address of the exchange
          example: '0x1F98431c8aD98523631AE4a59f267346ea31F984'
        pairAddress:
          type: string
          description: The pair address
          example: '0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640'
        pairLiquidityUsd:
          type: number
          description: The pair liquidity in USD
          example: 234567890.12
      required:
        - exchangeName
        - exchangeAddress
        - pairAddress
        - pairLiquidityUsd
    SingleChainResponseMetaDto:
      type: object
      properties:
        syncedAt:
          type: object
          description: Last ingested block number per chain ID
          additionalProperties:
            type: number
          example:
            bitcoin: latest
      required:
        - syncedAt
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key

````