Retrieving scam reports

The Get Reports API allows users to retrieve specific scam reports using specific filters such as keywords (coming soon), reported date, trusted contributor score, scam category, chain.

Using optional filters to retrieve reports

Chainabuse returns the relevant report(s), including the specific risk indicators and indicators of compromises they contain - more on the indicators in the response example below.

Authentication

API key to authorize requests. Enter your organization's API key in both the Username and Password fields below to authorize.

HTTP Authorization Scheme: basic

Request

REQUEST BODY SCHEMA: application/JSON

Query parametersTypeDescription
addressoptionalAddress(es) or domain(s) to use as an optional reports filter
trustedoptional- True: reported by a trusted contributor, based on how this Partner does detect and verifies information
- False: the reporter is not registered as a trusted contributor. Please note this does not mean their report cannot be trusted. It means we can now testify it.
chainoptionalBlockchain to use as an optional reports filter
categoryoptionalScam category to use as an optional reports filter
orderByDirectionoptionalIf several reports are pulled out, an option to order them by the latest/oldest report.
orderByFieldoptionalOrdering reports by date if several reports are pulled out
beforeoptionalThreshold date as an optional reports filter
sinceoptionalStart date to use as an optional reports filter
pageoptionalThe maximum number of pages of reports to pull out. By default, set to 1. The maximum number of reports per page is 50. If page =1, you will pull out a maximum of 50 reports
perPageoptionalThe number of reports to display per page. The maximum number of reports per page is 50. If page =1, you will pull out a maximum of 50 reports.

Retrieved information

List of relevant reports including:

For each report:

  • Reported scammer's address(es), if included
  • Reported scammer's domain,(s), if included
  • Scam category
  • Reported date
  • Report ID
  • Description
  • Number of votes (upvotes and downvotes) of the report

If reported

  • Scammer's information - such as Twitter handle, email, or other ICO - COMING SOON
  • Reported loss - COMING SOON

The victim's information (such as email) is never made available.