Skip to main content
GET
/
markets
/
{code}
/
calendar
Get market calendar
curl --request GET \
  --url https://api.bluumfinance.com/v1/markets/{code}/calendar \
  --header 'Authorization: Basic <encoded-value>'
{
  "object": "investor",
  "livemode": false,
  "code": "XNAS",
  "year": 2026,
  "holidays": [
    {
      "date": "2026-07-03",
      "name": "Independence Day",
      "early_close": "13:00"
    }
  ],
  "id": "inv_01j9x8m2k7qpzwv3t5r6y8n0ab",
  "created": 1747776000,
  "metadata": {},
  "common_code": "NASDAQ",
  "trading_hours": {
    "open": "09:30",
    "close": "16:00"
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

code
string
required

Query Parameters

year
integer

Calendar year (defaults to current year)

Example:

2026

Response

Market calendar

Envelope-wrapped market calendar (object: market_calendar).

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

code
string
required
Example:

"XNAS"

year
integer
required
Example:

2026

holidays
object[]
required
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.

common_code
string | null
Example:

"NASDAQ"

trading_hours
object