Addresses

Look up addresses, get wallet information, find related wallets.

Requires Authorization: Token <your token> in the header.

Lookup a wallet address using a hash and blockchain name and get predictions

GET https://api.starfall.ai/api/addresses/{hash}/?blockchain_name={blockchain_name}

Path Parameters

Name	Type	Description
hash*	String	Wallet address

Query Parameters

Name	Type	Description
blockchain_name*	String	Name of the blockchain from i.e. ethereum

200: OK

{
  "id": 0,
  "name": "string",
  "hash": "string",
  "is_blacklist": true,
  "blockchain_name": "string",
  "final_predictions": [
    {
      "id": 0,
      "predictions": [
        {
          "id": 0,
          "created": "2023-11-30T10:55:57.374Z",
          "modified": "2023-11-30T10:55:57.374Z",
          "model_version": "string",
          "model_name": "string",
          "fraud_data": {
            "additionalProp1": "string",
            "additionalProp2": "string",
            "additionalProp3": "string"
          },
          "bot_data": {
            "additionalProp1": "string",
            "additionalProp2": "string",
            "additionalProp3": "string"
          },
          "run_number": 2147483647,
          "address": 0
        }
      ],
      "created": "2023-11-30T10:55:57.374Z",
      "modified": "2023-11-30T10:55:57.374Z",
      "model_chosen": "string",
      "run_number": 2147483647,
      "fraud_probability": 0,
      "final_prediction": 2147483647,
      "fraud_message": "string",
      "has_erc20_token_transfers": true,
      "num_erc20_token_transfers": 2147483647,
      "has_transactions": true,
      "num_transactions": 2147483647,
      "is_bot": true,
      "address": 0
    }
  ]
}

Get a list of related wallets to the wallet based on signals and predictions

GET https://api.starfall.ai/api/addresses/{hash}/related/?blockchain_name={blockchain_name}

Gives a list of related wallets to the current wallet. Clusters wallets based on predictions and signals and returns the closest cluster of wallets.

Path Parameters

Name	Type	Description
hash*	String	Wallet Address

Query Parameters

Name	Type	Description
blockchain_name*	String	Name of the blockchain from i.e. ethereum

200: OK

{
  "id": 0,
  "name": "string",
  "hash": "string",
  "is_blacklist": true,
  "blockchain_name": "string",
  "final_predictions": [
    {
      "id": 0,
      "predictions": [
        {
          "id": 0,
          "created": "2023-11-30T11:02:18.337Z",
          "modified": "2023-11-30T11:02:18.337Z",
          "model_version": "string",
          "model_name": "string",
          "fraud_data": {
            "additionalProp1": "string",
            "additionalProp2": "string",
            "additionalProp3": "string"
          },
          "bot_data": {
            "additionalProp1": "string",
            "additionalProp2": "string",
            "additionalProp3": "string"
          },
          "run_number": 2147483647,
          "address": 0
        }
      ],
      "created": "2023-11-30T11:02:18.337Z",
      "modified": "2023-11-30T11:02:18.337Z",
      "model_chosen": "string",
      "run_number": 2147483647,
      "fraud_probability": 0,
      "final_prediction": 2147483647,
      "fraud_message": "string",
      "has_erc20_token_transfers": true,
      "num_erc20_token_transfers": 2147483647,
      "has_transactions": true,
      "num_transactions": 2147483647,
      "is_bot": true,
      "address": 0
    }
  ]
}