> ## 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/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="openToAnyCurator" type="boolean">Whether the market is offered to every approved lender of record, not only to the named candidates.</ResponseField>
        <ResponseField name="operatorShareBps" type="string">Share of post-infrastructure interest the deployment offers whoever takes the role, in basis points. This is the economics of the offer: read it before deciding.</ResponseField>
        <ResponseField name="marketDeployer" type="string">The wallet that deployed the market, or `null`. The deploying company is the natural candidate for the issuer field when the role is taken.</ResponseField>
        <ResponseField name="identityGate" type="object">What the market's identity registry answers and whether the market can work with it. `shape`, `usable` and `note`, described on [Get Market](/endpoints/lending/get-market#response-fields). A market whose gate is unusable cannot be adopted at all.</ResponseField>
        <ResponseField name="instrumentSummary" type="object">What the importing issuer published about the underlying instrument: `securityClass`, `maturityDate` and `perpetual`. `null` when nothing was published.</ResponseField>
        <ResponseField name="instrumentProvenance" type="string">`ISSUER_ASSERTED` when the summary above came from the issuer's own record, `ABSENT` when there is none. It is never a Trusset verification.</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 |
