Banks

A bank represents a financial institution in a specific country. The same bank in different countries is not associated, i.e. each bank is considered a separate entity.

The bank model

The bank model contains information about financial institutions.

Properties

Name: id
Type: string
Description: The bank's auto-generated unique identifier.

Name: name
Type: string
Constraints: min1•max256
Description: The bank's official name or display name.

Name: rank
Type: integer
Description: The bank's worldwide rank. Based on the bank's overall score, which is determined by user votes across all categories. Only banks with at least 10 votes are ranked.

Name: countryRank
Type: integer
Description: The bank's rank within the country. Based on the bank's overall score, which is determined by user votes across all categories. Only banks with at least 10 votes are ranked.

Name: url
Type: string
Description: The bank's official website URL.

Name: description
Type: string
Description: The bank's description in Markdown (md) format.

Name: storiesCount
Type: integer
Constraints: min0
Description: The number of stories for this bank.

Name: claimedAt
Type: string
Description

Name: scores
Type: object
Description: Vote totals and scores for this bank across all categories. All votes are cast by users.

Name: countryId
Type: string
Description: The ID of the country where this bank is located.

Name: createdAt
Type: string
Description: The date and time the bank was created in Moon Banking.

Name: updatedAt
Type: string
Description: The date and time the bank was last updated in Moon Banking.

Name: country
Type: object
Description: The country where the bank is located.

Name: stocks
Type: array
Description

GET/banks/by-hostnamePro

GET /banks

Retrieve a paginated list of banks, ten per page by default. Search by name, filter by country, sort by various fields, and include related data such as scores and country information.

Optional parameters

Name: limit
Type: integer
Constraints: min1•max100
Default: default10
Description: Number of items to return.

Name: starting_after
Type: string
Description: Cursor for forward pagination. Use the id of the last item from the previous page to get the next page.

Name: ending_before
Type: string
Description: Cursor for backward pagination. Use the id of the first item from the current page to get the previous page.

Name: search
Type: string
Description: Search banks by name.

Name

sortBy

Type

enum

Default

default"name"

Description

Field to sort by.

Possible values: name, rank, countryRank, storiesCount, countryId, overall_score, overall_total, overall_up, overall_down, cryptoFriendly_score, cryptoFriendly_total, cryptoFriendly_up, cryptoFriendly_down, customerService_score, customerService_total, customerService_up, customerService_down, feesPricing_score, feesPricing_total, feesPricing_up, feesPricing_down, digitalExperience_score, digitalExperience_total, digitalExperience_up, digitalExperience_down, securityTrust_score, securityTrust_total, securityTrust_up, securityTrust_down, accountFeatures_score, accountFeatures_total, accountFeatures_up, accountFeatures_down, branchAtmAccess_score, branchAtmAccess_total, branchAtmAccess_up, branchAtmAccess_down, internationalBanking_score, internationalBanking_total, internationalBanking_up, internationalBanking_down, businessBanking_score, businessBanking_total, businessBanking_up, businessBanking_down, processingSpeed_score, processingSpeed_total, processingSpeed_up, processingSpeed_down, transparency_score, transparency_total, transparency_up, transparency_down, innovation_score, innovation_total, innovation_up, innovation_down, investmentServices_score, investmentServices_total, investmentServices_up, investmentServices_down, lending_score, lending_total, lending_up, lending_down

Name

sortOrder

Type

enum

Default

default"asc"

Description

Sort order. Either ascending or descending.

Possible values: asc, desc

Name: include
Type: string
Description: An optional comma-separated list of fields to include in the response. Possible values: scores, country, meta, stocks

Name: countryId
Type: string
Description: Only return banks in the specified country. A country's ID is Moon Banking's unique identifier for the country.

Name: countryCode
Type: string
Description: Only return banks in the specified country. A country's code is the ISO 3166-1 code for the country. If both countryId and countryCode are provided, countryId will be used.

Request

GET

/banks

curl -G https://api.moonbanking.com/v1/banks \
  -H "Authorization: Bearer {your_api_key}" \
  -H "Moon-Banking-Version: 2025-07-11" \
  --data-urlencode "limit=20" \
  --data-urlencode "starting_after=8HsY5nBc7jAqM4u" \
  --data-urlencode "ending_before=6jkxE4N8gHXgDPK" \
  --data-urlencode "search=Fidelity" \
  --data-urlencode "sortBy=name" \
  --data-urlencode "sortOrder=asc" \
  --data-urlencode "include=scores%2Ccountry%2Cmeta%2Cstocks" \
  --data-urlencode "countryId=454hfjsjuusbf" \
  --data-urlencode "countryCode=US"

Response

{
  "success": true,
  "data": [
    {
      "id": "6jkxE4N8gHXgDPK",
      "name": "Fidelity",
      "rank": 1,
      "countryRank": 1,
      "url": "https://www.fidelity.com",
      "description": "# Fidelity\n\nFidelity is a financial institution that provides banksing and investment services to individuals.",
      "storiesCount": 10,
      "claimedAt": "sample_claimedAt",
      "scores": {
        "overall": {
          "total": 45,
          "up": 30,
          "down": 15,
          "score": 33
        },
        "cryptoFriendly": {
          "total": 12,
          "up": 8,
          "down": 4,
          "score": 33
        },
        "customerService": {
          "total": 10,
          "up": 7,
          "down": 3,
          "score": 40
        },
        "feesPricing": {
          "total": 8,
          "up": 5,
          "down": 3,
          "score": 25
        },
        "digitalExperience": {
          "total": 7,
          "up": 4,
          "down": 3,
          "score": 14
        },
        "securityTrust": {
          "total": 9,
          "up": 6,
          "down": 3,
          "score": 33
        },
        "accountFeatures": {
          "total": 6,
          "up": 4,
          "down": 2,
          "score": 33
        },
        "branchAtmAccess": {
          "total": 5,
          "up": 3,
          "down": 2,
          "score": 20
        },
        "internationalBanking": {
          "total": 4,
          "up": 3,
          "down": 1,
          "score": 50
        },
        "businessBanking": {
          "total": 6,
          "up": 4,
          "down": 2,
          "score": 33
        },
        "processingSpeed": {
          "total": 3,
          "up": 2,
          "down": 1,
          "score": 33
        },
        "transparency": {
          "total": 4,
          "up": 3,
          "down": 1,
          "score": 50
        },
        "innovation": {
          "total": 3,
          "up": 2,
          "down": 1,
          "score": 33
        },
        "investmentServices": {
          "total": 2,
          "up": 1,
          "down": 1,
          "score": 0
        },
        "lending": {
          "total": 2,
          "up": 1,
          "down": 1,
          "score": 0
        }
      },
      "countryId": "454hfjsjuusbf",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z",
      "country": {
        "id": "454hfjsjuusbf",
        "name": "United States",
        "code": "US",
        "emoji": "🇺🇸"
      },
      "stocks": [
        {
          "id": "5bKqNzTx8mLrW3v",
          "symbol": "BAC",
          "isPrimary": false,
          "marketId": "5bKqNzTx8mLrW3v",
          "bankId": "6jkxE4N8gHXgDPK",
          "createdAt": "2024-01-15T10:30:00.000Z",
          "updatedAt": "2024-01-15T10:30:00.000Z",
          "market": {
            "id": "5bKqNzTx8mLrW3v",
            "name": "New York Stock Exchange",
            "code": "NYSE",
            "tvCode": "NYSE",
            "isTvEmbeddable": true,
            "type": "STOCK",
            "countryId": "5bKqNzTx8mLrW3v",
            "createdAt": "2024-01-15T10:30:00.000Z",
            "updatedAt": "2024-01-15T10:30:00.000Z"
          },
          "bank": {
            "id": "6jkxE4N8gHXgDPK",
            "name": "Fidelity",
            "url": "https://www.fidelity.com",
            "rank": 1,
            "countryRank": 1,
            "countryId": "454hfjsjuusbf"
          }
        },
    ...
  ]
    },
    ...
  ],
  "pagination": {
    "hasMore": true,
    "limit": 20,
    "nextCursor": "8HsY5nBc7jAqM4u",
    "previousCursor": "6jkxE4N8gHXgDPK",
    "meta": {
      "total": 42
    }
  },
  "message": "Sample message",
  "timestamp": "2026-04-09T00:39:30.636Z",
  "version": "2025-07-11"
}

GET/banks/:idPro

GET /banks/:id

Retrieve a bank by ID. Optionally include related data such as scores and country information.

Required parameters

Name: id
Type: string
Description: The bank's auto-generated unique identifier.

Optional parameters

Name: include
Type: string
Description: An optional comma-separated list of fields to include in the response. Possible values: scores, country, stocks

Request

GET

/banks/:id

curl -G https://api.moonbanking.com/v1/banks/6jkxE4N8gHXgDPK \
  -H "Authorization: Bearer {your_api_key}" \
  -H "Moon-Banking-Version: 2025-07-11" \
  --data-urlencode "include=scores%2Ccountry%2Cstocks"

Response

{
  "success": true,
  "data": {
    "id": "6jkxE4N8gHXgDPK",
    "name": "Fidelity",
    "rank": 1,
    "countryRank": 1,
    "url": "https://www.fidelity.com",
    "description": "# Fidelity\n\nFidelity is a financial institution that provides banksing and investment services to individuals.",
    "storiesCount": 10,
    "claimedAt": "sample_claimedAt",
    "scores": {
      "overall": {
        "total": 45,
        "up": 30,
        "down": 15,
        "score": 33
      },
      "cryptoFriendly": {
        "total": 12,
        "up": 8,
        "down": 4,
        "score": 33
      },
      "customerService": {
        "total": 10,
        "up": 7,
        "down": 3,
        "score": 40
      },
      "feesPricing": {
        "total": 8,
        "up": 5,
        "down": 3,
        "score": 25
      },
      "digitalExperience": {
        "total": 7,
        "up": 4,
        "down": 3,
        "score": 14
      },
      "securityTrust": {
        "total": 9,
        "up": 6,
        "down": 3,
        "score": 33
      },
      "accountFeatures": {
        "total": 6,
        "up": 4,
        "down": 2,
        "score": 33
      },
      "branchAtmAccess": {
        "total": 5,
        "up": 3,
        "down": 2,
        "score": 20
      },
      "internationalBanking": {
        "total": 4,
        "up": 3,
        "down": 1,
        "score": 50
      },
      "businessBanking": {
        "total": 6,
        "up": 4,
        "down": 2,
        "score": 33
      },
      "processingSpeed": {
        "total": 3,
        "up": 2,
        "down": 1,
        "score": 33
      },
      "transparency": {
        "total": 4,
        "up": 3,
        "down": 1,
        "score": 50
      },
      "innovation": {
        "total": 3,
        "up": 2,
        "down": 1,
        "score": 33
      },
      "investmentServices": {
        "total": 2,
        "up": 1,
        "down": 1,
        "score": 0
      },
      "lending": {
        "total": 2,
        "up": 1,
        "down": 1,
        "score": 0
      }
    },
    "countryId": "454hfjsjuusbf",
    "createdAt": "2024-01-15T10:30:00.000Z",
    "updatedAt": "2024-01-15T10:30:00.000Z",
    "country": {
      "id": "454hfjsjuusbf",
      "name": "United States",
      "code": "US",
      "emoji": "🇺🇸"
    },
    "stocks": [
      {
        "id": "5bKqNzTx8mLrW3v",
        "symbol": "BAC",
        "isPrimary": false,
        "marketId": "5bKqNzTx8mLrW3v",
        "bankId": "6jkxE4N8gHXgDPK",
        "createdAt": "2024-01-15T10:30:00.000Z",
        "updatedAt": "2024-01-15T10:30:00.000Z",
        "market": {
          "id": "5bKqNzTx8mLrW3v",
          "name": "New York Stock Exchange",
          "code": "NYSE",
          "tvCode": "NYSE",
          "isTvEmbeddable": true,
          "type": "STOCK",
          "countryId": "5bKqNzTx8mLrW3v",
          "createdAt": "2024-01-15T10:30:00.000Z",
          "updatedAt": "2024-01-15T10:30:00.000Z"
        },
        "bank": {
          "id": "6jkxE4N8gHXgDPK",
          "name": "Fidelity",
          "url": "https://www.fidelity.com",
          "rank": 1,
          "countryRank": 1,
          "countryId": "454hfjsjuusbf"
        }
      },
    ...
  ]
  },
  "message": "Sample message",
  "timestamp": "2026-04-09T00:39:30.636Z",
  "version": "2025-07-11"
}

GET/banks/semantic-searchPro

GET /banks/semantic-search

Search for banks by describing what you are looking for in natural language. Searches across bank descriptions including services offered, history, location, unique features, and institution type. Use when the user asks about banks with specific characteristics, services, or qualities.

Required parameters

Name: query
Type: string
Constraints: min1•max1000
Description: A detailed, specific natural language sentence describing what the user is looking for. Combine all relevant context: location, institution type, user occupation or eligibility, services needed, and any preferences. Write a full descriptive sentence, NOT a keyword list.

Optional parameters

Name: limit
Type: integer
Constraints: min1•max50
Default: default10
Description: Maximum number of bank results to return.

Name: countryCode
Type: string
Description: Filter results to banks in this country (ISO 3166-1 code).

Request

GET

/banks/semantic-search

curl -G https://api.moonbanking.com/v1/banks/semantic-search \
  -H "Authorization: Bearer {your_api_key}" \
  -H "Moon-Banking-Version: 2025-07-11" \
  --data-urlencode "query=banks%20with%20strong%20digital%20banking%20and%20mobile%20apps" \
  --data-urlencode "limit=10" \
  --data-urlencode "countryCode=US"

Response

{
  "success": true,
  "data": [
    {
      "bankId": "6jkxE4N8gHXgDPK",
      "bankName": "Fidelity",
      "similarity": 42,
      "matchingSection": "sample_matchingSection",
      "sectionTitle": "sample_sectionTitle"
    },
    ...
  ],
  "message": "Sample message",
  "timestamp": "2026-04-09T00:39:30.636Z",
  "version": "2025-07-11"
}

Banks

The bank model

Properties

GET /banks/by-hostname

Required parameters

Optional parameters

Request

Response

GET /banks

Optional parameters

Request

Response

GET /banks/:id

Required parameters

Optional parameters

Request

Response

GET /banks/semantic-search

Required parameters

Optional parameters

Request

Response