Trusset Protocol - Infrastructure for Asset Tokenization

GET

lending-external-securities-v2

api

markets

{marketId}

access-role

{address}

curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/access-role/0x5b7e2d91c04a38f6e1d9a72b3c8f40e6d15a9c27?role=ROUTER_OPERATOR" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/access-role/${address}?role=ROUTER_OPERATOR`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();

{
  "success": true,
  "data": {
    "address": "0x5b7e2d91c04a38f6e1d9a72b3c8f40e6d15a9c27",
    "role": "ROUTER_OPERATOR",
    "roleName": "OPERATOR_ROLE",
    "contract": "0x8c3a5e0f2b71d94c6e08a3f5b2d7c19e4a60f835",
    "granted": true,
    "failed": false
  }
}

{
  "success": true,
  "data": {
    "address": "0x5b7e2d91c04a38f6e1d9a72b3c8f40e6d15a9c27",
    "role": "ROUTER_OPERATOR",
    "roleName": "OPERATOR_ROLE",
    "contract": "0x8c3a5e0f2b71d94c6e08a3f5b2d7c19e4a60f835",
    "granted": null,
    "failed": true
  }
}

{
  "success": false,
  "error": {
    "code": "UNKNOWN_ROLE",
    "message": "A supported role is required"
  }
}

Reads from the chain whether an address holds one of the six roles that Set Access Role grants and revokes. Use it before building a change, or to confirm which wallet can sign an administrative transaction. For ORACLE_SIGNER, the oracle owner reads as granted, because the owner can sign prices without a grant.

Path Parameters

string

required

Market ID.

string

required

Address to check. Must be a 0x-prefixed 40-character hex address other than the zero address.

Query Parameters

string

required

One of MARKET_ADMIN, MARKET_ISSUER, MARKET_LIQUIDATOR, ROUTER_ADMIN, ROUTER_OPERATOR or ORACLE_SIGNER. The role table says what each one controls.

Response Fields

object

Show child attributes

string

The address checked, echoed back as sent.

string

The role key checked.

string

The on-chain role: DEFAULT_ADMIN_ROLE, ISSUER_ROLE, LIQUIDATOR_ROLE, OPERATOR_ROLE, or Price signing for ORACLE_SIGNER.

string

The contract the role was read from: the market, its liquidation router or its oracle.

boolean

Whether the address holds the role. null when the chain read failed.

boolean

true when the role could not be read from the chain.

A failed chain read still returns 200, with granted: null and failed: true. Treat it as unknown, not as a revoked role, and retry.

curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/access-role/0x5b7e2d91c04a38f6e1d9a72b3c8f40e6d15a9c27?role=ROUTER_OPERATOR" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/access-role/${address}?role=ROUTER_OPERATOR`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();

{
  "success": true,
  "data": {
    "address": "0x5b7e2d91c04a38f6e1d9a72b3c8f40e6d15a9c27",
    "role": "ROUTER_OPERATOR",
    "roleName": "OPERATOR_ROLE",
    "contract": "0x8c3a5e0f2b71d94c6e08a3f5b2d7c19e4a60f835",
    "granted": true,
    "failed": false
  }
}

{
  "success": true,
  "data": {
    "address": "0x5b7e2d91c04a38f6e1d9a72b3c8f40e6d15a9c27",
    "role": "ROUTER_OPERATOR",
    "roleName": "OPERATOR_ROLE",
    "contract": "0x8c3a5e0f2b71d94c6e08a3f5b2d7c19e4a60f835",
    "granted": null,
    "failed": true
  }
}

{
  "success": false,
  "error": {
    "code": "UNKNOWN_ROLE",
    "message": "A supported role is required"
  }
}

Error Codes

Code	HTTP	Cause
`NO_MARKET_ADDRESS`	`400`	The market has no on-chain address recorded, or no market address could be resolved for a market role
`INVALID_ADDRESS`	`400`	The path address is malformed or is the zero address
`UNKNOWN_ROLE`	`400`	`role` is missing or is not one of the six keys
`NO_ROUTER`	`400`	A router role was requested and no liquidation router address could be resolved for the market
`NO_ORACLE`	`400`	`ORACLE_SIGNER` was requested and the market records no oracle
`MISSING_MARKET_ID`	`400`	`marketId` is longer than 100 characters
`MARKET_NOT_FOUND`	`404`	No market with this ID on your instance

curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/access-role/0x5b7e2d91c04a38f6e1d9a72b3c8f40e6d15a9c27?role=ROUTER_OPERATOR" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/access-role/${address}?role=ROUTER_OPERATOR`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();

{
  "success": true,
  "data": {
    "address": "0x5b7e2d91c04a38f6e1d9a72b3c8f40e6d15a9c27",
    "role": "ROUTER_OPERATOR",
    "roleName": "OPERATOR_ROLE",
    "contract": "0x8c3a5e0f2b71d94c6e08a3f5b2d7c19e4a60f835",
    "granted": true,
    "failed": false
  }
}

{
  "success": true,
  "data": {
    "address": "0x5b7e2d91c04a38f6e1d9a72b3c8f40e6d15a9c27",
    "role": "ROUTER_OPERATOR",
    "roleName": "OPERATOR_ROLE",
    "contract": "0x8c3a5e0f2b71d94c6e08a3f5b2d7c19e4a60f835",
    "granted": null,
    "failed": true
  }
}

{
  "success": false,
  "error": {
    "code": "UNKNOWN_ROLE",
    "message": "A supported role is required"
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Asset Register

Vaults

Get Access Role

Path Parameters

Query Parameters

Response Fields

Error Codes

​Path Parameters

​Query Parameters

​Response Fields

​Error Codes

Path Parameters

Query Parameters

Response Fields

Error Codes