Skip to main content
GET
/
assets
/
search
Search for assets by ticker, name, or partial match
curl --request GET \
  --url https://api.bluumfinance.com/v1/assets/search \
  --header 'Authorization: Basic <encoded-value>'
{
  "object": "list",
  "url": "/v1/assets/search",
  "has_more": false,
  "data": [
    {
      "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"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
q
string

Search query (ticker, name, or partial match). If not provided, returns all assets up to the limit.

​
status
enum<string>
default:active

Filter by asset status. Defaults to 'active'.

Available options:
active,
inactive
​
class
enum<string>

Filter by canonical instrument class.

Available options:
equity,
etf,
bond,
bill,
note,
mutual_fund,
derivative,
cryptocurrency,
commodity,
real_estate,
cash
​
country
string

Filter by ISO 3166-1 alpha-2 country code (lower-case, e.g. us, ng).

​
limit
integer
default:50

Maximum number of results to return. Defaults to 50, maximum is 100.

Required range: 1 <= x <= 100

Response

List of matching assets

List envelope. data holds the page of items; each item is itself wrapped in a ResourceEnvelope.

​
object
enum<string>
required
Available options:
list
​
url
string
required

The endpoint path that produced this list.

Example:

"/v1/investors/inv_…/deposits"

​
has_more
boolean
required

Whether more results exist beyond data.

Example:

false

​
data
object[]
required