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

# Providers

> Discover inference provider capabilities, settlement, and top-up routes

Returns the configured provider registry. Clients should use capability and
status fields instead of constructing upstream URLs or payment recipients.

<ResponseField name="data" type="array">
  Provider descriptors.

  <Expandable title="properties">
    <ResponseField name="id" type="string">
      Stable lowercase provider id used as the public model prefix.
    </ResponseField>

    <ResponseField name="status" type="string">
      `available` or `funding_only`.
    </ResponseField>

    <ResponseField name="payment" type="string">
      Provider chat payment kind.
    </ResponseField>

    <ResponseField name="capabilities" type="object">
      Boolean chat, models, balance, and top-up support.
    </ResponseField>

    <ResponseField name="settlement" type="object">
      Optional CAIP-2 network, asset, and decimals.
    </ResponseField>

    <ResponseField name="topup" type="object">
      Optional gateway URL, merchant id, and settlement chain.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "data": [
      {
        "id": "dolphin",
        "label": "Dolphin",
        "payment": "none",
        "status": "available",
        "capabilities": {
          "chat": true,
          "models": true,
          "balance": false,
          "topup": false
        }
      },
      {
        "id": "surplus",
        "label": "Surplus Intelligence",
        "payment": "x402",
        "status": "available",
        "settlement": {
          "network": "eip155:8453",
          "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
          "decimals": 6
        },
        "topup": {
          "gatewayUrl": "https://api-antseed.mrdn.finance",
          "merchant": "surplus",
          "settlementChainId": 8453
        }
      }
    ]
  }
  ```
</ResponseExample>