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

GET/banks/by-hostname

This endpoint allows you to retrieve banks by hostname. It will return up to one bank per country that matches the provided hostname. The hostname is normalized (www. prefix removed if present) and matched against both the primary hostname and alternative hostnames.

Required parameters

Name: hostname
Type: string
Constraints: min1
Description: The hostname to search for (e.g., "fidelity.com" or "www.fidelity.com").

Optional parameters

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

Name: pageTitle
Type: string
Description: The title of the web page.

Request

GET

/banks/by-hostname

curl -G https://api.moonbanking.com/v1/banks/by-hostname \
  -H "Authorization: Bearer {your_api_key}" \
  -H "Moon-Banking-Version: 2025-07-11" \
  --data-urlencode "hostname=fidelity.com" \
  --data-urlencode "include=scores%2Ccountry" \
  --data-urlencode "pageTitle=Fidelity%20Investments"

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,
      "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": "🇺🇸"
      }
    },
    ...
  ],
  "message": "Sample message",
  "timestamp": "2026-02-12T21:20:01.631Z",
  "version": "2025-07-11"
}

GET/banks

GET /banks

This endpoint allows you to retrieve a paginated list of all banks. By default, a maximum of ten banks are shown per page. You can search banks by name, filter by country, sort them by various fields, and include related data like 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

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" \
  --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,
      "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": "🇺🇸"
      }
    },
    ...
  ],
  "pagination": {
    "hasMore": true,
    "limit": 20,
    "nextCursor": "8HsY5nBc7jAqM4u",
    "previousCursor": "6jkxE4N8gHXgDPK",
    "meta": {
      "total": 42
    }
  },
  "message": "Sample message",
  "timestamp": "2026-02-12T21:20:01.632Z",
  "version": "2025-07-11"
}

GET/banks/:id

GET /banks/:id

This endpoint allows you to retrieve a specific bank by providing the bank ID. You can include related data like scores and country information in the response.

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

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"

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,
    "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": "🇺🇸"
    }
  },
  "message": "Sample message",
  "timestamp": "2026-02-12T21:20:01.632Z",
  "version": "2025-07-11"
}