Get the effective market status of a token

curl --request GET \
  --url https://partners-api.sandbox.securitize.io/corporate-actions/v1/tokens/{tokenId}/status \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://partners-api.sandbox.securitize.io/corporate-actions/v1/tokens/{tokenId}/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://partners-api.sandbox.securitize.io/corporate-actions/v1/tokens/{tokenId}/status"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "tokenId": "7f3b2c10-5d4e-4a6b-9c8d-1e2f3a4b5c6d",
  "assetId": "c0a8e2f4-1b3d-4e5f-8a9b-0c1d2e3f4a5b",
  "marketStatus": "OPEN",
  "reason": null,
  "activeRestrictions": [],
  "asOf": "2026-10-20T14:05:13.439Z"
}

Tokens

Get the effective market status of a token

Whether the token can be traded now, and why not. marketStatus is UNAVAILABLE while any restriction that stops trading applies to the token, its asset or the underlying market, with reason set to the reasonCode of the most restrictive one; otherwise it is the underlying market’s status, OPEN or CLOSED, with the market’s own reason (for example PRE_MARKET). When the market cannot be read the token is UNAVAILABLE with MARKET_STATUS_UNKNOWN, never OPEN by default. activeRestrictions lists every restriction in force at the three scopes.

GET

/

tokens

/

{tokenId}

/

status

Get the effective market status of a token

curl --request GET \
  --url https://partners-api.sandbox.securitize.io/corporate-actions/v1/tokens/{tokenId}/status \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://partners-api.sandbox.securitize.io/corporate-actions/v1/tokens/{tokenId}/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://partners-api.sandbox.securitize.io/corporate-actions/v1/tokens/{tokenId}/status"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "tokenId": "7f3b2c10-5d4e-4a6b-9c8d-1e2f3a4b5c6d",
  "assetId": "c0a8e2f4-1b3d-4e5f-8a9b-0c1d2e3f4a5b",
  "marketStatus": "OPEN",
  "reason": null,
  "activeRestrictions": [],
  "asOf": "2026-10-20T14:05:13.439Z"
}

Authorizations

Authorization

string

header

required

OAuth 2.0 client credentials. Exchange the client id and secret Securitize issued you for a bearer token at the token URL, with grant_type=client_credentials; the token lasts 2 hours and goes in the Authorization: Bearer header of every request. No scope is needed.

Path Parameters

tokenId

string

required

The token's id, as GET /tokens lists it. One per chain deployment.

Response

The effective status.

tokenId

string

required

Example:

"7f3b2c10-5d4e-4a6b-9c8d-1e2f3a4b5c6d"

assetId

string

required

Example:

"c0a8e2f4-1b3d-4e5f-8a9b-0c1d2e3f4a5b"

marketStatus

enum<string>

required

UNAVAILABLE while a restriction that stops trading applies at any scope; otherwise the underlying market's status.

Available options:

OPEN,

CLOSED,

UNAVAILABLE

reason

string | null

required

Why. The reasonCode of the most restrictive restriction when UNAVAILABLE because of one; otherwise the market's reason, for example PRE_MARKET, POST_MARKET or MARKET_STATUS_UNKNOWN. null when there is none.

Example:

"POST_MARKET"

activeRestrictions

object[]

required

Every restriction in force on the token, its asset and the underlying market.

Show child attributes

asOf

string<date-time>

required

When this status was computed.