Screening addresses

The** Get Reports API allows users to screen addresses and URLs to verify whether they have been reported as linked to malicious activity on Chainabuse.


Submit one or more crypto addresses to be screened through the Get Reports API

If the address has been reported, Chainabuse returns the relevant report(s) and specific additional 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
addressmandatory (for this use case)Crypto address to be used as a filter to retrieve reports
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 as an optional filter
categoryoptionalScam category as an optional filter
orderByDirectionoptionalIf several reports are pulled out, option to order them by the latest/oldest report.
orderByFieldoptionalOrdering reports by date if several reports are pulled out
beforeoptionalThreshold date as an optional filter
sinceoptionalStart date to use as an optional filter
pageoptionalThe maximum number of pages of reports to pull out. The maximum number of reports per page is 50. If page =1, you will pull out a maximum of 50 reports
perPageoptionalNumber 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 the screened address(es) and:

For each report:

  • Reported scammer's address(es)
  • 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.