PlatformInstitutionalPricingAbout

ALPHRACTAL API

Crypto market intelligence for your applications.

Build trading models, research pipelines and automated workflows with Alphractal’s market, on-chain, derivatives, liquidation, sentiment and macro data.

GET /btc/market/PriceUSDX-Api-Key: ••••••••••••••••ALPHRACTAL API[{ "time": "2023-11-07T05:31:56Z", "priceUSD": 123}]priceUSDResearch pipelineAnalytics dashboardAutomated workflow

Choose the data your workflow needs.

Discover asset-level time series, cross-asset views and metadata. Availability varies by endpoint, asset and exchange.

  • Market data

    Price, market capitalization, returns and volatility for asset analysis and monitoring.

    Examples Price USD · Market Cap · OHLCV

  • On-chain & valuation

    Network activity, supply distribution, holder behavior and cost-basis measures.

    Examples Active Addresses · SOPR · Realized Price · MVRV

  • Derivatives & positioning

    Leverage conditions and trader positioning across supported derivatives markets.

    Examples Funding Rate · Open Interest · Whale vs Retail Delta

  • Liquidation levels

    Query liquidation heatmaps, snapshots and price zones for supported markets.

    Examples Heatmap · Snapshot · Zones

  • Exchange flows

    On-chain inflows, outflows and reserves associated with tracked exchange entities.

    Examples Exchange Netflow · Inflows · Outflows · Exchange Reserves

  • Cycle indicators & Alphractal models

    Access documented cycle indicators and model series for deeper market analysis.

    Examples ADCI · TBBI · CVDD Model 2

  • Sentiment & macro

    Add market sentiment, economic series and liquidity context to your workflow.

    Examples Fear and Greed · Interest rates · Dollar indices · Money supply

  • Discovery & screening

    Find supported assets, inspect endpoint parameters and retrieve cross-asset screening views.

    Examples Asset catalog · Endpoint metadata · Screener

API coverage is defined by the documented endpoints. Visual charts in the application may combine or transform multiple data series.

Coverage follows the metric.

Explore supported assets such as Bitcoin, Ethereum, Cardano, Dogecoin, Litecoin and Zcash. Exchange coverage differs between price data, derivatives and on-chain flows.

Exchange examples by data family
Data familyExchange examples
Price & volumeBinance · Bybit · OKX · Coinbase · Kraken
Derivatives & positioningBinance · Bybit · OKX · Bitget · Deribit
Liquidation levelsBinance · Bybit · OKX · Bitget · Kraken
On-chain flowsBinance · Bybit · OKX · Bitfinex · Bitstamp

From API key to structured data.

  1. Get your key

    Sign in to Alphractal and manage your API key from the API dashboard. Your key determines the endpoints and usage limits available to you.

    Open API dashboard →
  2. Choose an endpoint

    Find the metric, asset and supported parameters in the API reference. Use the documented date range and resolution for your request.

    Browse the API reference →
  3. Read the response

    Authenticate the request and process the JSON response in your application. Check the returned timestamps, credit balance and status code.

    Read the integration guide →

Request Bitcoin price data

Authenticate with your API key and read the returned time series.

curl --request GET \  --url 'https://api.alphractal.com/btc/market/PriceUSD' \  --header "X-Api-Key: ${ALPHRACTAL_API_KEY}"

Set ALPHRACTAL_API_KEY in your server environment before running this example. Keep the key out of browser code and public repositories.

Example response shape

[  {    "time": "2023-11-07T05:31:56Z",    "priceUSD": 123  }]

Illustrative values from the endpoint documentation. This is not a live market quote.

time identifies the data point in UTC. priceUSD is the USD price field. Other endpoints return their own documented fields and response shapes.

View this endpoint

Know how the API behaves.

How the API behaves
ItemDetails
Protocol & formatREST endpoints over HTTPS, with JSON responses.
AuthenticationSend your API key in the X-Api-Key header. The documentation also supports bearer-key authentication.
Date rangesUse startDate and endDate where supported to select a historical window. Available history depends on the metric and your plan.
ResolutionIntraday and daily buckets are available for supported market and derivatives series. On-chain, macro and sentiment availability follows the endpoint definition.
TimestampsAPI timestamps use UTC and ISO 8601. A series’ resolution and its source publication schedule are different things.
Response shapeMost asset-level metric endpoints return an array of time-stamped data points. Discovery, screening and liquidation endpoints may use different structures.
CreditsEach authenticated API request costs 10 credits under the documented standard model. Non-2xx responses are refunded.
Rate limitsRequests per minute are limited separately from your credit balance. Your API key carries the applicable limit.

Handle access and usage limits explicitly.

Use the documented status and error details when handling a failed request. A plan restriction, an exhausted credit balance and a rate limit require different handling.

  1. 403

    The key does not have access to the requested endpoint.

  2. 402

    The available credit allocation has been exhausted.

  3. 429

    The request rate exceeded the key’s limit.

  4. 503

    The API may reject the request when credit accounting is temporarily unavailable.

Build with the API. Connect through MCP.

API

Use HTTP requests when your application controls the integration, scheduling and response handling.

Read API documentation →

MCP

Connect compatible AI clients and agents to Alphractal tools through the Model Context Protocol.

Explore MCP →

FAQ

API questions, answered.

  • Sign in to your Alphractal account and open the API dashboard. Your key determines access to endpoints and the usage limits that apply.

Start building withAlphractal data.

Explore the documentation, check your API access and connect the data your workflow needs.