> ## 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.

# List Pending Markets

> List markets published as seeking a lender of record

Returns markets the lending factory publishes as seeking a lender of record. See [Lender of record](/endpoints/external-securities-lending/introduction#lender-of-record).

<Note>
  This view is factory-wide, not instance-scoped. It lists every market on the network your instance resolves to that is currently seeking a lender of record, including markets deployed by other issuers. It is the only endpoint on this surface that is not limited to your own instance's markets. Nothing here is actionable through an API key: an institution takes the role from its own Trusset issuer account.
</Note>

## Query Parameters

<ParamField query="limit" type="integer" default="25">
  Markets to return. Minimum 1, maximum 100.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Markets to skip. Minimum 0.
</ParamField>

## Response Fields

<ResponseField name="data" type="object">
  <Expandable>
    <ResponseField name="markets" type="array">
      Markets seeking a lender of record.

      <Expandable>
        <ResponseField name="marketAddress" type="string">Market contract address.</ResponseField>
        <ResponseField name="collateralTokenAddress" type="string">Collateral token.</ResponseField>
        <ResponseField name="collateralTokenName" type="string">Collateral token name.</ResponseField>
        <ResponseField name="collateralTokenSymbol" type="string">Collateral token symbol.</ResponseField>
        <ResponseField name="collateralTokenIsin" type="string">ISIN recorded on the collateral token, or null.</ResponseField>
        <ResponseField name="collateralDecimals" type="integer">Collateral token decimals.</ResponseField>
        <ResponseField name="collateralMode" type="string">`FREEZE` or `CUSTODY`.</ResponseField>
        <ResponseField name="priceSource" type="string">`NAV` or `MARKET`.</ResponseField>
        <ResponseField name="oracleAddress" type="string">Price oracle deployed for this market.</ResponseField>
        <ResponseField name="interestModelAddress" type="string">Interest rate model.</ResponseField>
        <ResponseField name="insuranceFundAddress" type="string">Insurance fund.</ResponseField>
        <ResponseField name="adapterAddress" type="string">Collateral adapter.</ResponseField>
        <ResponseField name="liquidationRouterAddress" type="string">Liquidation router dedicated to this market.</ResponseField>
        <ResponseField name="identityRegistryAddress" type="string">Identity registry for the collateral token, or null.</ResponseField>
        <ResponseField name="borrowAssetAddress" type="string">Settlement token (stablecoin).</ResponseField>
        <ResponseField name="borrowAssetSymbol" type="string">Settlement token symbol.</ResponseField>
        <ResponseField name="borrowAssetDecimals" type="integer">Settlement token decimals.</ResponseField>
        <ResponseField name="seekingCurator" type="boolean">`true` for every row in this view.</ResponseField>
        <ResponseField name="curator" type="string">Null while the market is seeking a lender of record.</ResponseField>
        <ResponseField name="realizationMode" type="string">`UNDECLARED` until the role is taken.</ResponseField>
        <ResponseField name="liquidityCommitment" type="string">Liquidity the lender of record commits on adoption, in the borrow asset's smallest unit. `0` before adoption.</ResponseField>
        <ResponseField name="candidates" type="array">Addresses nominated for the role.</ResponseField>
        <ResponseField name="factoryGeneration" type="string">Factory generation that deployed the market.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="total" type="integer">Total markets seeking a lender of record.</ResponseField>
    <ResponseField name="offset" type="integer">Applied offset.</ResponseField>
    <ResponseField name="limit" type="integer">Applied limit.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.trusset.org/lending-external-securities/api/markets/queue/pending?limit=10" \
    -H "X-API-Key: trusset_your_key_here"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "markets": [
        {
          "marketAddress": "0x1c74f9a2b0e63d581a47c02f9b8de3517a604c2b",
          "collateralTokenAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
          "collateralTokenName": "ACME Industrial Bond 2031",
          "collateralTokenSymbol": "ACME",
          "collateralTokenIsin": "DE000A2YN900",
          "collateralDecimals": 18,
          "collateralMode": "FREEZE",
          "priceSource": "NAV",
          "oracleAddress": "0x3b25752c1459c5cf1b0bfcfdf0d56883c8047423",
          "interestModelAddress": "0xd410b8e35297af6d0c1745be82a37f09b6534ce1",
          "insuranceFundAddress": "0x8f1a6b30c7d24e95f0a3b81d6c47e2905fa3b9c2",
          "adapterAddress": "0x4d2b93f70e18c6a5d34b027fe95c81a6730d77ae",
          "liquidationRouterAddress": "0x067a3feea46649adad8e31c33b3a4d8774b8d8cf",
          "identityRegistryAddress": "0x9e3c8a15f4d70b2681c5a3f9027d4be8115c7d21",
          "borrowAssetAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
          "borrowAssetSymbol": "USDC",
          "borrowAssetDecimals": 6,
          "seekingCurator": true,
          "curator": null,
          "realizationMode": "UNDECLARED",
          "liquidityCommitment": "0",
          "candidates": ["0x4e91a7c05d3b62f18a0c94e7db2358f1c60a4e93"],
          "factoryGeneration": "curator"
        }
      ],
      "total": 1,
      "offset": 0,
      "limit": 10
    }
  }
  ```
</ResponseExample>

## Error Codes

| Code                 | HTTP  | Cause                                                                                   |
| -------------------- | ----- | --------------------------------------------------------------------------------------- |
| `FACTORY_UNREADABLE` | `503` | The lending factory on this network does not publish markets seeking a lender of record |
