> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Market Register

> The asset register named for the collateral token of a market, and its answer

Returns the asset register the deployer named for the collateral token behind a market, and whether that register has imported the market.

The record opens to every instance that holds a record of the market: the instance that deployed it and the instance of its lender of record. `canEdit` says which of the two is calling. Only the deploying instance can change the register, with [Set Market Register](https://docs.trusset.org/endpoints/asset-register/set-market-register.md) and [Clear Market Register](https://docs.trusset.org/endpoints/asset-register/clear-market-register.md).

> [!NOTE]
>
> The asset register is recorded beside the market, not in it. `onChain` is always `false` and `appliesTo` is always `TOKEN`: the assignment covers every market of the same deployer on the same collateral token.

A register provider does not read this endpoint for its own markets. It holds no record of the market, so the call answers `404 MARKET_NOT_FOUND`. It reads [List Register Markets](https://docs.trusset.org/endpoints/asset-register/list-register-markets.md) instead.

## Path Parameters

**marketAddress** `string` *required*

The market contract address, `0x` followed by 40 hex characters. Lowercase or correctly checksummed.

## Response Fields

**data** `object`

**marketAddress** `string`

The market, lowercased.

**tokenAddress** `string`

The collateral token the assignment belongs to, lowercased. `null` when the market records no collateral token.

**canEdit** `boolean`

`true` for the instance that deployed the market. `false` for a lender of record, which reads the register and cannot change it. A change is checked on chain again when it is made.

**appliesTo** `string`

Always `TOKEN`.

**onChain** `boolean`

Always `false`. The assignment is not part of the lending contracts.

**register** `object`

`null` while no register is named.

**instanceId** `string`

The named register instance.

**instanceName** `string`

Its instance name.

**companyName** `string`

The register provider's company name.

**registerKind** `string`

`ON_CHAIN` or `OFF_CHAIN`, as the provider declared it.

**registerKindLabel** `string`

`On-chain register` or `Off-chain register`.

**response** `string`

`PENDING` until the register answers for this market, `IMPORTED` once it imported the market, `DECLINED` when it declined it. `IMPORTED` says the register took the market into its instance. It does not say that a register entry exists.

**respondedAt** `string`

When the register last answered, ISO 8601. `null` while `response` is `PENDING`.

**assignedAt** `string`

When the deployer named this register for the token, ISO 8601.

**listed** `boolean`

`false` when the register has since taken its listing down, archived the instance or lost its approval. The assignment stays until the deployer clears it.

```bash cURL theme={null}
curl "https://api.trusset.org/asset-registers/api/markets/0x70a0e25c7b768b87e658348b3b577678a173e038/register" \
  -H "X-API-Key: trusset_your_key_here"
```

```typescript TypeScript theme={null}
const res = await fetch(
  `https://api.trusset.org/asset-registers/api/markets/${marketAddress}/register`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const imported = data.register?.response === 'IMPORTED';
```

```json Response theme={null}
{
  "success": true,
  "data": {
    "marketAddress": "0x70a0e25c7b768b87e658348b3b577678a173e038",
    "tokenAddress": "0x39478e924930d7fed1fa3803ecf9b0ddc08ce512",
    "canEdit": true,
    "appliesTo": "TOKEN",
    "onChain": false,
    "register": {
      "instanceId": "cmwk2r8v10003l80f4t6h9d2e",
      "instanceName": "Register Production",
      "companyName": "Elbe Register GmbH",
      "registerKind": "OFF_CHAIN",
      "registerKindLabel": "Off-chain register",
      "response": "IMPORTED",
      "respondedAt": "2026-11-18T10:31:07.000Z",
      "assignedAt": "2026-11-18T10:14:52.000Z",
      "listed": true
    }
  },
  "error": null,
  "metadata": {
    "timestamp": "2026-11-18T10:40:03.000Z",
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "instanceId": "cmrz4d1v20000cghx8k6p3m7t"
  }
}
```

## Error Codes

| Code | HTTP | Cause |
| - | - | - |
| `VALIDATION_ERROR` | `400` | `marketAddress` is not `0x` followed by 40 hex characters |
| `INVALID_ADDRESS` | `400` | `marketAddress` is the zero address, or mixed case with a failing checksum |
| `AUTH_REQUIRED` | `401` | No `X-API-Key` header |
| `AUTH_FAILED` | `401` | The key is malformed, unknown, expired, or its instance is archived |
| `CREDIT_LIMIT_EXCEEDED` | `402` | The instance's monthly credit allowance is exhausted |
| `ACCOUNT_FROZEN` | `403` | The account behind the key is suspended |
| `MARKET_NOT_FOUND` | `404` | This instance holds no lending market with this address |
| `RATE_LIMIT_EXCEEDED` | `429` | More than 100 reads in the minute |
| `REGISTER_READ_FAILED` | `500` | The record could not be read |
| `DEPLOYER_UNREAD` | `503` | The deployment of the market could not be read from the chain, so its register cannot be decided. Retry shortly |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.