Skip to main content
GET
/
market-data
/
assets
/
{symbol}
Get asset profile with latest quote
curl --request GET \
  --url https://api.bluumfinance.com/v1/market-data/assets/{symbol} \
  --header 'Authorization: Basic <encoded-value>'
{
  "id": "b0b6dd9d-8b9b-48b9-bbb8-bbbb49bb1bbb",
  "object": "investor",
  "livemode": false,
  "class": "equity",
  "country": "us",
  "market": "XNAS",
  "market_name": "NASDAQ",
  "market_country": "US",
  "market_currency": "USD",
  "symbol": "AAPL",
  "name": "Apple Inc.",
  "status": "active",
  "tradable": true,
  "marginable": true,
  "shortable": true,
  "easy_to_borrow": true,
  "fractionable": true,
  "fractional_eh_enabled": true,
  "currency": "USD",
  "created": 1747776000,
  "metadata": {},
  "price": 178.5,
  "change": 1.5,
  "changePercent": 0.85,
  "previousClose": 177,
  "bidPrice": 178.48,
  "askPrice": 178.52,
  "price_timestamp": "2026-05-29T20:00:00.000Z",
  "last_synced_at": "2026-06-01T02:12:31.000Z",
  "bond": {
    "cusip": "00037BAC6",
    "isin": "US00037BAC63",
    "bond_status": "outstanding",
    "bond_type": "corporate",
    "bond_subtype": "bond",
    "maturity_date": "2042-05-08",
    "issue_date": "2012-05-08",
    "dated_date": "2023-12-25",
    "first_coupon_date": "2023-12-25",
    "next_coupon_date": "2023-12-25",
    "last_coupon_date": "2023-12-25",
    "coupon_rate": "4.375",
    "coupon_type": "fixed",
    "coupon_frequency": 2,
    "accrual_basis": "30/360",
    "accrued_interest": 2.795139,
    "face_value": "1000",
    "min_increment": "2000",
    "settlement_period": 2,
    "close_price_date": "2026-05-29",
    "yield_to_maturity": 5.485755,
    "yield_to_worst": 5.485755,
    "callable": false,
    "puttable": false,
    "convertible": false,
    "perpetual": false,
    "next_call_date": "2023-12-25",
    "next_call_price": 123,
    "call_type": "make_whole",
    "issuer": "ABB Finance (USA) Inc.",
    "ticker": "ABBNVX",
    "sector": "Capital Goods",
    "seniority": "Senior",
    "country_domicile": "US",
    "rating": "AAA",
    "sp_rating": "AAA",
    "sp_outlook": "stable"
  }
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
symbol
string
required

Asset ticker symbol

Query Parameters

​
market
string

Market hint (MIC or common code) for disambiguation

Response

Asset profile

Envelope-wrapped asset resource (object: asset).

​
id
string
required

Unique identifier for the asset

Example:

"b0b6dd9d-8b9b-48b9-bbb8-bbbb49bb1bbb"

​
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

​
class
enum<string>
required

Canonical instrument class. Combine with country for the full picture (e.g. class=equity + country=us corresponds to a US stock).

Available options:
equity,
etf,
bond,
bill,
note,
mutual_fund,
derivative,
cryptocurrency,
commodity,
real_estate,
cash
Example:

"equity"

​
country
string | null
required

ISO 3166-1 alpha-2 country code (lower-case). Null for country-agnostic instruments.

Example:

"us"

​
market
string
required

Market/exchange code (ISO 10383 MIC):

  • XNAS: NASDAQ
  • XNYS: NYSE
  • BATS: BATS Global Markets
  • ARCA: NYSE Arca
  • OTC: OTC Markets
  • XNSA: Nigerian Exchange
  • XNAI: Nairobi Securities Exchange
Example:

"XNAS"

​
market_name
string
required

Common exchange/market identifier for display:

  • NASDAQ: NASDAQ (US)
  • NYSE: New York Stock Exchange (US)
  • NGX: Nigerian Exchange (NG)
  • NSE: Nairobi Securities Exchange (KE)
Example:

"NASDAQ"

​
market_country
string | null
required

ISO 3166-1 alpha-2 country code of the exchange (upper-case). Null for global/crypto venues.

Example:

"US"

​
market_currency
string
required

Primary trading currency of the exchange (ISO 4217).

Example:

"USD"

​
symbol
string
required

Asset ticker symbol. For fixed-income assets this is the bond ticker when Alpaca provides one (corporates, e.g. "ABBNVX"); treasuries, which have no ticker, fall back to the CUSIP. The CUSIP is always available as id and under bond.cusip.

Example:

"AAPL"

​
name
string
required

Full name of the asset

Example:

"Apple Inc."

​
status
enum<string>
required

Asset status

Available options:
active,
inactive
Example:

"active"

​
tradable
boolean
required

Whether the asset is currently tradable

Example:

true

​
marginable
boolean
required

Whether the asset can be traded on margin

Example:

true

​
shortable
boolean
required

Whether the asset can be shorted

Example:

true

​
easy_to_borrow
boolean
required

Whether the asset is easy to borrow for shorting

Example:

true

​
fractionable
boolean
required

Whether the asset can be traded in fractional shares

Example:

true

​
fractional_eh_enabled
boolean
required

Whether the asset supports fractional trading during extended hours (pre/post market)

Example:

true

​
currency
string
required

Currency code for asset pricing (ISO 4217)

Example:

"USD"

​
created
integer | null

Unix-seconds timestamp of resource creation.

Example:

1747776000

​
metadata
object

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

​
price
number

Current/last traded price (optional, when available)

Example:

178.5

​
change
number

Price change from previous close (optional)

Example:

1.5

​
changePercent
number

Percentage change from previous close (optional)

Example:

0.85

​
previousClose
number

Previous day's closing price (optional)

Example:

177

​
bidPrice
number

Current best bid price (optional)

Example:

178.48

​
askPrice
number

Current best ask price (optional)

Example:

178.52

​
price_timestamp
string<date-time> | null

When the price was recorded by its source. Use this to judge price recency.

Example:

"2026-05-29T20:00:00.000Z"

​
last_synced_at
string<date-time> | null

When the asset row was last refreshed from its provider. Null for live (never-persisted) results.

Example:

"2026-06-01T02:12:31.000Z"

​
bond
object

Fixed-income attributes. Populated only when class is bond / bill / note. Equity / crypto / ETF assets omit this block.