bluepages.fyi

{
  "oneOf": [
    {
      "description": "Address lookup response (query.type === 'address')",
      "properties": {
        "address": {
          "description": "Resolved Ethereum address",
          "type": "string"
        },
        "cluster": {
          "properties": {
            "addresses": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "id": {
              "type": "string"
            },
            "identified": {
              "type": "boolean"
            },
            "source": {
              "type": "string"
            },
            "totalAddresses": {
              "type": "integer"
            },
            "truncated": {
              "type": "boolean"
            }
          },
          "type": "object"
        },
        "found": {
          "enum": [
            true
          ],
          "type": "boolean"
        },
        "identities": {
          "items": {
            "properties": {
              "source": {
                "type": "string"
              },
              "type": {
                "enum": [
                  "twitter",
                  "email",
                  "farcaster",
                  "username"
                ],
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "type": "array"
        },
        "labels": {
          "description": "Known labels for this address (e.g., CEX, DEX, bridge)",
          "items": {
            "properties": {
              "detail": {
                "description": "Specific wallet identifier (e.g., 'Binance 1')",
                "type": "string"
              },
              "name": {
                "description": "Entity name (e.g., 'Binance')",
                "type": "string"
              },
              "source": {
                "description": "Data source (e.g., 'hildobby')",
                "type": "string"
              },
              "type": {
                "description": "Label category (e.g., 'cex')",
                "type": "string"
              }
            },
            "type": "object"
          },
          "type": "array"
        },
        "query": {
          "properties": {
            "type": {
              "enum": [
                "address"
              ],
              "type": "string"
            },
            "value": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "sanctions": {
          "description": "Sanctions entries for this address from all sources (current and historical)",
          "items": {
            "properties": {
              "active": {
                "description": "Whether the sanction is currently active",
                "type": "boolean"
              },
              "addedAt": {
                "description": "Date added to sanctions list (YYYY-MM-DD)",
                "type": "string"
              },
              "entity": {
                "description": "Sanctioned entity name (e.g., 'LAZARUS GROUP')",
                "type": "string"
              },
              "programs": {
                "description": "Sanctions programs or regimes (e.g., ['CYBER2', 'DPRK'])",
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "removedAt": {
                "description": "Date removed from sanctions list (null if still active)",
                "nullable": true,
                "type": "string"
              },
              "source": {
                "description": "Sanctions list source identifier (e.g., 'ofac_sdn', 'uk_ofsi')",
                "type": "string"
              }
            },
            "type": "object"
          },
          "type": "array"
        },
        "timestamp": {
          "format": "date-time",
          "type": "string"
        },
        "twitterSearch": {
          "description": "Pointer to the /search/tweets endpoint for live Twitter/X search",
          "properties": {
            "available": {
              "type": "boolean"
            },
            "endpoint": {
              "description": "Full endpoint URL with address",
              "type": "string"
            },
            "price": {
              "description": "Cost per search",
              "type": "string"
            }
          },
          "type": "object"
        }
      },
      "type": "object"
    },
    {
      "description": "Identity lookup response (query.type === 'identity')",
      "properties": {
        "found": {
          "enum": [
            true
          ],
          "type": "boolean"
        },
        "query": {
          "properties": {
            "type": {
              "enum": [
                "identity"
              ],
              "type": "string"
            },
            "value": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "results": {
          "items": {
            "description": "A matched record: spreads the same fields as the address-lookup response, with extra matchType/matchedValue fields.",
            "properties": {
              "address": {
                "type": "string"
              },
              "cluster": {
                "type": "object"
              },
              "identities": {
                "items": {
                  "type": "object"
                },
                "type": "array"
              },
              "labels": {
                "description": "Known labels for this address (e.g., CEX, DEX, bridge)",
                "items": {
                  "properties": {
                    "detail": {
                      "description": "Specific wallet identifier (e.g., 'Binance 1')",
                      "type": "string"
                    },
                    "name": {
                      "description": "Entity name (e.g., 'Binance')",
                      "type": "string"
                    },
                    "source": {
                      "description": "Data source (e.g., 'hildobby')",
                      "type": "string"
                    },
                    "type": {
                      "description": "Label category (e.g., 'cex')",
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "type": "array"
              },
              "matchType": {
                "type": "string"
              },
              "matchedValue": {
                "type": "string"
              },
              "sanctions": {
                "description": "Sanctions entries for this address from all sources (current and historical)",
                "items": {
                  "properties": {
                    "active": {
                      "type": "boolean"
                    },
                    "addedAt": {
                      "type": "string"
                    },
                    "entity": {
                      "type": "string"
                    },
                    "programs": {
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "removedAt": {
                      "nullable": true,
                      "type": "string"
                    },
                    "source": {
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "type": "array"
              }
            },
            "type": "object"
          },
          "type": "array"
        },
        "timestamp": {
          "format": "date-time",
          "type": "string"
        },
        "totalMatches": {
          "type": "integer"
        }
      },
      "type": "object"
    }
  ]
}