Skip to main content
GET
/
assets
/
{symbol}
Get a single asset by symbol/ticker
curl --request GET \
  --url https://api.bluumfinance.com/v1/assets/{symbol} \
  --header 'Authorization: Basic <encoded-value>'
{
  "object": "asset",
  "livemode": false,
  "id": "b0b6dd9d-8b9b-48b9-bbb8-bbbb49bb1bbb",
  "class": "equity",
  "country": "us",
  "market": "XNAS",
  "market_name": "NASDAQ",
  "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",
  "price": 178.5,
  "change": 1.5,
  "changePercent": 0.85,
  "previousClose": 177,
  "bidPrice": 178.48,
  "askPrice": 178.52
}

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 (e.g., AAPL, MSFT, DANGOTE)

Query Parameters

​
market
enum<string>

Optional market hint for faster lookup. If provided, only the corresponding provider is queried. Without this hint, all providers are searched.

Available options:
XNAS,
XNYS,
BATS,
ARCA,
OTC,
XNSA
​
market_country
string

Optional ISO 3166-1 alpha-2 market-country hint (e.g. US, NG), used when market is not provided. Resolves to the corresponding exchange(s)/provider for that country — useful for clients that only know the country, not the MIC code. Ignored if market is also set.

Response

Asset information with current price data

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.