---
title: "Get one venue's price or funding series for an asset"
url: https://docs.truemarkets.co/api/market-data/get-venue-history
description: "Returns a single venue's series for an asset, one point per `interval`\nbucket holding the last value seen in it. Buckets with no data are\nomitted. Points are oldest first. Internal: Envoy does not route this\npath, so only services inside the network reach it.\n\nA request is capped at 50,000 buckets: `window` divided by `interval`\nabove that is a 400 (`30d` at `1m` is 43,200 and allowed; `7d` at `5s`\nis 120,960 and rejected).\n\nSources per `venue`, all matched on `asset_id`:\n\n| venue | metric | source |\n|---|---|---|\n| `robinhood`, `base` | `price` | CoinGecko onchain price on that chain; 0x price on that chain when CoinGecko has no row in the window |\n| `solana` | `price` | Jupiter price |\n| `hyperliquid` | `price` | Hyperliquid spot mid |\n| `hyperliquid-perp` | `price` | Hyperliquid perp mid |\n| `hyperliquid-perp` | `funding` | Hyperliquid hourly funding rate as a decimal fraction |\n| `cefi` | `price` | CeFi EBBO midpoint, (bid + ask) / 2 |\n"
---

Docs index: https://docs.truemarkets.co/llms.txt

# Get one venue's price or funding series for an asset

Returns a single venue's series for an asset, one point per `interval`
bucket holding the last value seen in it. Buckets with no data are
omitted. Points are oldest first. Internal: Envoy does not route this
path, so only services inside the network reach it.

A request is capped at 50,000 buckets: `window` divided by `interval`
above that is a 400 (`30d` at `1m` is 43,200 and allowed; `7d` at `5s`
is 120,960 and rejected).

Sources per `venue`, all matched on `asset_id`:

| venue | metric | source |
|---|---|---|
| `robinhood`, `base` | `price` | CoinGecko onchain price on that chain; 0x price on that chain when CoinGecko has no row in the window |
| `solana` | `price` | Jupiter price |
| `hyperliquid` | `price` | Hyperliquid spot mid |
| `hyperliquid-perp` | `price` | Hyperliquid perp mid |
| `hyperliquid-perp` | `funding` | Hyperliquid hourly funding rate as a decimal fraction |
| `cefi` | `price` | CeFi EBBO midpoint, (bid + ask) / 2 |

## Request

```
GET https://api.truemarkets.co/v1/marketdata/venue-history
```

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `asset_id` | query | string (uuid) | yes | Backend asset ID. |
| `venue` | query | string, one of `robinhood`, `base`, `solana`, `hyperliquid`, `hyperliquid-perp`, `cefi` | yes | Venue whose series to read. |
| `metric` | query | string, one of `price`, `funding` | no | Series to read. `funding` is served only for `hyperliquid-perp`. |
| `window` | query | string | yes | Lookback period (e.g. `1h`, `1d`, `7d`), at most `30d` and at most 50,000 intervals. |
| `interval` | query | string, one of `5s`, `30s`, `1m`, `5m`, `1h` | yes | Bucket size. |

## Responses

Every error status returns the same body, described in [Errors](https://docs.truemarkets.co/developer-resources/errors.md).

### 200

The venue's series for the asset

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `asset_id` | string (uuid) | yes | Backend asset ID |
| `venue` | string | yes | The venue the series was read from |
| `metric` | string | yes | The series read, `price` or `funding` |
| `interval` | string | yes | The bucket size |
| `points` | array of object | yes | One point per bucket with data, oldest first |
| `points[].t` | string (date-time) | yes | RFC 3339 start of the bucket |
| `points[].v` | string | yes | Last value in the bucket as a decimal string |

### 400

Bad request - invalid parameters, or more than 50,000 buckets

### 404

The venue has no series for the asset in the window

### 500

Internal server error