Skip to main content
GET
/
markets
/
{code}
Get market details
curl --request GET \
  --url https://api.bluumfinance.com/v1/markets/{code} \
  --header 'Authorization: Basic <encoded-value>'
{
  "object": "investor",
  "livemode": false,
  "code": "XNSA",
  "name": "Nigerian Stock Exchange",
  "country": "NG",
  "currency": "NGN",
  "timezone": "Africa/Lagos",
  "status": "active",
  "id": "inv_01j9x8m2k7qpzwv3t5r6y8n0ab",
  "created": 1747776000,
  "metadata": {},
  "common_code": "NGX",
  "trading_hours": {
    "open": "10:00",
    "close": "14:30"
  },
  "extended_hours_supported": true,
  "current_status": {
    "is_open": true,
    "next_open": "2023-11-07T05:31:56Z",
    "next_close": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
code
string
required

Market identifier (MIC code like XNSA, or common code like NGX)

Response

Market details

Envelope-wrapped market (object: market).

​
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

ISO 10383 MIC code

Example:

"XNSA"

​
name
string
required

Full market name

Example:

"Nigerian Stock Exchange"

​
country
string
required

ISO 2-letter country code

Example:

"NG"

​
currency
string
required

Primary trading currency (ISO 4217)

Example:

"NGN"

​
timezone
string
required

IANA timezone

Example:

"Africa/Lagos"

​
status
enum<string>
required
Available options:
active,
inactive,
holiday
Example:

"active"

​
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

Human-friendly market code

Example:

"NGX"

​
trading_hours
object
​
extended_hours_supported
boolean

Whether the venue supports pre/post-market trading

​
current_status
object

Current session status (best-effort; omitted on enrichment failure)