Skip to main content
GET
/
assets
/
chart
Get historical chart/bar data for an asset
curl --request GET \
  --url https://api.bluumfinance.com/v1/assets/chart \
  --header 'Authorization: Basic <encoded-value>'
{
  "object": "asset_chart",
  "livemode": false,
  "symbol": "AAPL",
  "bars": [
    {
      "timestamp": "2025-01-15T16:00:00Z",
      "open": 175.25,
      "high": 177.5,
      "low": 174.8,
      "close": 176.75,
      "volume": 5000000,
      "tradeCount": 12500,
      "volumeWeightedAveragePrice": 176.2
    },
    {
      "timestamp": "2025-01-14T16:00:00Z",
      "open": 174,
      "high": 175.5,
      "low": 173.5,
      "close": 175.25,
      "volume": 4800000,
      "tradeCount": 12000,
      "volumeWeightedAveragePrice": 174.75
    },
    {
      "timestamp": "2025-01-13T16:00:00Z",
      "open": 173.5,
      "high": 174.8,
      "low": 172.9,
      "close": 174,
      "volume": 5200000,
      "tradeCount": 13000,
      "volumeWeightedAveragePrice": 173.9
    }
  ],
  "nextPageToken": null
}

Authorizations

​
Authorization
string
header
required

HTTP Basic Authentication using the API Key as username and API Secret as password.

Query Parameters

​
symbol
string
required

Asset ticker symbol (e.g., AAPL, MSFT, BTCUSD)

​
timeframe
enum<string>
required

Bar timeframe

Available options:
1Min,
5Min,
15Min,
30Min,
1Hour,
1Day,
1Week,
1Month
​
start
string<date-time>

Start date/time (ISO 8601 format). If not provided, returns most recent bars up to limit.

​
end
string<date-time>

End date/time (ISO 8601 format). If not provided, uses current time.

​
limit
integer
default:100

Maximum number of bars to return. Defaults to 100, maximum is 10000.

Required range: 1 <= x <= 10000
​
adjustment
enum<string>
default:raw

Corporate action adjustment. 'raw' = no adjustment, 'split' = split adjusted, 'dividend' = dividend adjusted, 'all' = both adjusted.

Available options:
raw,
split,
dividend,
all
​
feed
enum<string>
default:iex

Data feed source. 'iex' = IEX (free), 'sip' = SIP (premium), 'otc' = OTC.

Available options:
iex,
sip,
otc

Response

Chart data with historical bars

Envelope-wrapped legacy chart response (object: asset_chart).

​
object
string
required

The resource type discriminator.

Example:

"investor"

​
livemode
boolean
required

Whether this resource was created against a live API key. Test-mode keys always return false.

Example:

false

​
symbol
string
required

Asset ticker symbol

Example:

"AAPL"

​
bars
object[]
required

Array of historical bars

​
id
string

Prefixed public id (e.g. inv_…, ord_…, dep_…).

Example:

"inv_01j9x8m2k7qpzwv3t5r6y8n0ab"

​
created
integer | null

Unix-seconds timestamp of resource creation.

Example:

1747776000

​
metadata
object

Partner-set key/value map for cross-referencing.

​
nextPageToken
string | null

Token for pagination to get next page of results.

Example:

"eyJpZCI6IjIwMjUtMDEtMTVUMTY6MDA6MDBaIiwiY3JlYXRlZEF0IjoiMjAyNS0wMS0xNVQxNjowMDowMFoifQ"