Skip to main content
GET
/
node
/
v1
/
data
/
{base}
/
{quote}
Get the latest price entry for a trading pair
curl --request GET \
  --url https://{environment}.pragma.build/node/v1/data/{base}/{quote} \
  --header 'x-api-key: <api-key>'
{
  "components": [
    {
      "price": "0x6cc61113f5871b1000",
      "source": "BINANCE",
      "timestamp": 1743082057
    }
  ],
  "decimals": 18,
  "num_sources_aggregated": 5,
  "pair_id": "BTC/USD",
  "price": "0x1234567890abcdef",
  "timestamp": 1647820800
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
base
string
required

Base asset symbol (e.g. BTC)

​
quote
string
required

Quote asset symbol (e.g. USD)

Query Parameters

​
timestamp
null | any

The unix timestamp in seconds to retrieve historical price data. This endpoint will return the first update whose timestamp is <= the provided value.

If not provided, returns the latest available price.

Examples

  • 1_647_820_800: Returns price data from March 21, 2022 00:00:00 UTC
  • null: Returns the most recent price update

NOTE: This only works for median aggregation

​
interval
null | enum<string>

Time interval for aggregated price data. Different intervals affect how price data is aggregated and can be used to get OHLC (Open/High/Low/Close) data at various timeframes.

Available intervals

  • 100ms: 100 milliseconds - High frequency trading
  • 1s: 1 second - Real-time trading
  • 5s: 5 seconds - Short-term price movements
  • 1min: 1 minute - Intraday trading
  • 15min: 15 minutes - Medium-term analysis
  • 1h: 1 hour - Daily trading patterns
  • 2h: 2 hours (default) - Extended market analysis
  • 1d: 1 day - Long-term trends
  • 1w: 1 week - Strategic market overview
Available options:
100ms,
1s,
5s,
10s,
1min,
5min,
15min,
1h,
2h,
1d,
1w
​
routing
boolean | null

Enable price routing through intermediate pairs. When true, if a direct price for the requested pair is not available, the system will attempt to calculate it using intermediate pairs.

Example

For BTC/EUR when routing is enabled:

  • If direct BTC/EUR price is unavailable
  • System might route through BTC/USD and EUR/USD

Default: true

​
aggregation
null | enum<string>

Method used to aggregate prices from multiple sources.

Available modes

  • median: Middle value (default, more manipulation resistant)
  • mean: Average of all values
  • twap: Time-Weighted Average Price
Available options:
median,
twap
​
entry_type
null | enum<string>

Type of market entry to retrieve

Available types

  • spot: Spot market prices (default)
  • perp: Perpetual futures prices
  • future: Fixed-expiry futures prices
Available options:
spot,
perp,
future
​
expiry
string | null

Expiry date for future contracts in ISO 8601 format. Only applicable when entry_type is "future".

Example

  • "2024-12-31": December 31, 2024 expiry
  • null: Not applicable for spot/perp markets
​
with_components
boolean | null

Include source components in the response. When true, the response will include price data from individual sources.

Example

  • true: Include source breakdown in response
  • false: Return aggregated data only (default)

Response

Successfully retrieved price entry

​
decimals
integer<int32>
required
Required range: x >= 0
​
num_sources_aggregated
integer
required
Required range: x >= 0
​
pair_id
string
required
​
price
string
required
​
timestamp
integer<int64>
required
Required range: x >= 0
​
components
object[] | null