Probity Wallet Reputation

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['runIdA', 'runIdB'], 'properties': {'runIdA': {'type': 'string', 'description': 'First screeningId (rsr_...). Must be a completed screen you own.'}, 'runIdB': {'type': 'string', 'description': 'Second screeningId (rsr_...). Must be a completed screen you own.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['mode', 'scoreDelta', 'runA', 'runB', 'reasonDiff', 'compositionDiff'], 'properties': {'mode': {'enum': ['temporal_delta', 'side_by_side'], 'type': 'string', 'description': 'temporal_delta when both runs are the same address, else side_by_side'}, 'runA': {'type': 'object', 'required': ['screeningId', 'address', 'ensName', 'score', 'bandCode', 'band', 'confidence', 'transactionCount', 'screenedAt', 'reportUrl'], 'properties': {'band': {'type': 'string', 'description': 'Reputation band, e.g. Low Risk'}, 'score': {'type': 'number', 'description': 'Signed reputation score from -100 to +100. Lower is worse.'}, 'address': {'type': 'string', 'description': 'The screened address'}, 'ensName': {'type': ['string', 'null'], 'description': 'ENS name for the address, when known'}, 'bandCode': {'type': 'string', 'description': 'Band identifier, e.g. LOW_RISK'}, 'reportUrl': {'type': 'string', 'description': 'Link to the full report on the Probity dashboard'}, 'confidence': {'anyOf': [{'enum': ['High', 'Medium', 'Low'], 'type': 'string'}, {'type': 'null'}], 'description': 'Engine confidence for this run'}, 'screenedAt': {'type': 'string', 'description': 'When this screen ran (ISO-8601)'}, 'screeningId': {'type': 'string', 'description': 'The rsr_... id of this run'}, 'transactionCount': {'type': 'integer', 'description': 'Number of transactions analysed'}}, 'additionalProperties': False}, 'runB': {'$ref': '#/properties/runA'}, 'reasonDiff': {'type': 'object', 'required': ['added', 'removed', 'changed'], 'properties': {'added': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'factor', 'severity', 'message'], 'properties': {'code': {'type': 'string'}, 'factor': {'type': 'string'}, 'message': {'type': 'string'}, 'severity': {'$ref': '#/properties/runA/properties/confidence/anyOf/0'}}, 'additionalProperties': False}, 'description': 'Reasons present in runA but not runB'}, 'changed': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'factor', 'from', 'to', 'message'], 'properties': {'to': {'$ref': '#/properties/runA/properties/confidence/anyOf/0'}, 'code': {'type': 'string'}, 'from': {'$ref': '#/properties/runA/properties/confidence/anyOf/0'}, 'factor': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Reasons in both runs whose severity changed from runB to runA'}, 'removed': {'type': 'array', 'items': {'$ref': '#/properties/reasonDiff/properties/added/items'}, 'description': 'Reasons present in runB but not runA'}}, 'description': 'What changed between the two runs at the reason level', 'additionalProperties': False}, 'scoreDelta': {'type': 'number', 'description': 'runA score minus runB score'}, 'compositionDiff': {'type': 'array', 'items': {'type': 'object', 'required': ['group', 'label', 'side', 'change', 'widthPctA', 'widthPctB'], 'properties': {'side': {'enum': ['raising', 'lowering'], 'type': 'string'}, 'group': {'type': 'string'}, 'label': {'type': 'string'}, 'change': {'enum': ['appeared', 'strengthened', 'weakened', 'removed'], 'type': 'string'}, 'widthPctA': {'type': 'number'}, 'widthPctB': {'type': 'number'}}, 'additionalProperties': False}, 'description': 'Which score drivers differ between the runs'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Number of past runs to return (1-50, default 5, newest first)'}, 'address': {'type': 'string', 'description': 'Ethereum address (0x...) or .eth ENS name to look up historic screenings for'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['screeningId', 'address', 'ensName', 'score', 'bandCode', 'band', 'confidence', 'sanctioned', 'transactionCount', 'evidence', 'screenedAt', 'reportUrl'], 'properties': {'band': {'type': 'string', 'description': 'Reputation band, e.g. Low Risk'}, 'score': {'type': 'number', 'description': 'Signed reputation score from -100 to +100. Lower is worse.'}, 'address': {'type': 'string', 'description': 'The screened address'}, 'ensName': {'type': ['string', 'null'], 'description': 'ENS name for the address, when known'}, 'bandCode': {'type': 'string', 'description': 'Band identifier, e.g. LOW_RISK'}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'factor', 'severity', 'message'], 'properties': {'code': {'type': 'string'}, 'factor': {'type': 'string'}, 'message': {'type': 'string'}, 'severity': {'enum': ['High', 'Medium', 'Low'], 'type': 'string'}}, 'additionalProperties': False}, 'description': 'Up to 10 signals behind this run, most severe first'}, 'reportUrl': {'type': ['string', 'null'], 'description': 'Link to the full report on the Probity dashboard'}, 'confidence': {'anyOf': [{'enum': ['High', 'Medium', 'Low'], 'type': 'string'}, {'type': 'null'}], 'description': 'Engine confidence for this run'}, 'sanctioned': {'type': 'boolean', 'description': 'True if the address is a direct OFAC match'}, 'screenedAt': {'type': 'string', 'description': 'When the screen ran (ISO-8601)'}, 'screeningId': {'type': ['string', 'null'], 'description': 'Immutable run id (rsr_...)'}, 'transactionCount': {'type': 'integer', 'description': 'Number of transactions analysed'}}, 'additionalProperties': False}, 'description': 'Recent screening runs, newest first, each with the same detail as screen_address'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Number of events (1-100, default 20)'}, 'since': {'type': 'string', 'description': 'ISO-8601 lower bound. Only events at or after this time are returned.'}, 'until': {'type': 'string', 'description': 'ISO-8601 upper bound. Only events at or before this time are returned.'}, 'cursor': {'type': 'string', 'description': 'Pass the nextCursor from a prior call to page forward.'}, 'address': {'type': 'string', 'description': 'Restrict to one monitored address (0x...). Omit for the whole portfolio.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['events', 'digest', 'nextCursor', 'hasMore'], 'properties': {'digest': {'type': 'string', 'description': 'Deterministic rollup of the events in this window'}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'address', 'detectedAt', 'triggerType', 'direction', 'minor', 'summary', 'bandFrom', 'bandTo'], 'properties': {'id': {'type': 'string', 'description': 'Event id. Pass it as cursor to page past this event.'}, 'minor': {'type': 'boolean', 'description': 'True for a trivial change safe to de-emphasise'}, 'bandTo': {'type': 'string', 'description': 'Reputation band after the change'}, 'address': {'type': 'string', 'description': 'The monitored address'}, 'summary': {'type': 'string', 'description': 'Summary of the change'}, 'bandFrom': {'type': 'string', 'description': 'Reputation band before the change'}, 'direction': {'type': 'string', 'description': 'downgrade or upgrade'}, 'detectedAt': {'type': 'string', 'description': 'When the change was detected (ISO-8601)'}, 'triggerType': {'type': 'string', 'description': 'Primary change type: floor_added, band_downgrade, band_upgrade, or score_delta'}}, 'additionalProperties': False}, 'description': 'Monitoring events in the window, oldest first'}, 'hasMore': {'type': 'boolean', 'description': 'True when more events remain past this page'}, 'nextCursor': {'type': ['string', 'null'], 'description': 'Cursor for the next page, or null when none remain'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Number of results (1-100, default 20)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['screeningId', 'address', 'ensName', 'score', 'bandCode', 'band', 'confidence', 'sanctioned', 'transactionCount', 'evidence', 'screenedAt', 'reportUrl'], 'properties': {'band': {'type': 'string', 'description': 'Reputation band, e.g. Low Risk'}, 'score': {'type': 'number', 'description': 'Signed reputation score from -100 to +100. Lower is worse.'}, 'address': {'type': 'string', 'description': 'The screened address'}, 'ensName': {'type': ['string', 'null'], 'description': 'ENS name for the address, when known'}, 'bandCode': {'type': 'string', 'description': 'Band identifier, e.g. LOW_RISK'}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'factor', 'severity', 'message'], 'properties': {'code': {'type': 'string'}, 'factor': {'type': 'string'}, 'message': {'type': 'string'}, 'severity': {'enum': ['High', 'Medium', 'Low'], 'type': 'string'}}, 'additionalProperties': False}, 'description': 'Up to 10 signals behind this run, most severe first'}, 'reportUrl': {'type': ['string', 'null'], 'description': 'Link to the full report on the Probity dashboard'}, 'confidence': {'anyOf': [{'enum': ['High', 'Medium', 'Low'], 'type': 'string'}, {'type': 'null'}], 'description': 'Engine confidence for this run'}, 'sanctioned': {'type': 'boolean', 'description': 'True if the address is a direct OFAC match'}, 'screenedAt': {'type': 'string', 'description': 'When the screen ran (ISO-8601)'}, 'screeningId': {'type': ['string', 'null'], 'description': 'Immutable run id (rsr_...)'}, 'transactionCount': {'type': 'integer', 'description': 'Number of transactions analysed'}}, 'additionalProperties': False}, 'description': 'Recent screening runs, newest first, each with the same detail as screen_address'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['screeningId'], 'properties': {'screeningId': {'type': 'string', 'description': 'The rsr_... id returned by screen_address. Must reference a completed screen; the narrative can be pending for a few seconds right after the screen returns.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['screeningId', 'address', 'narrative', 'concerns', 'reportUrl'], 'properties': {'address': {'type': 'string', 'description': 'The screened address'}, 'concerns': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Key concerns raised by the review'}, 'narrative': {'type': 'string', 'description': 'The enhanced review text'}, 'reportUrl': {'type': 'string', 'description': 'Link to the full report on the Probity dashboard'}, 'screeningId': {'type': 'string', 'description': 'The screen this review belongs to'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'address': {'type': 'string', 'description': 'Ethereum address (0x...) or `.eth` ENS name (e.g. vitalik.eth) to screen. ENS names resolve to their current mainnet address and must resolve or the call errors. Addresses are case-insensitive and need not be checksummed.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['screeningId', 'address', 'score', 'bandCode', 'band', 'confidence', 'sanctioned', 'transactionCount', 'summary', 'evidence', 'screenedAt', 'reportUrl'], 'properties': {'band': {'type': 'string', 'description': 'Reputation band, e.g. Low Risk, Reputable'}, 'score': {'type': 'number', 'description': 'Signed reputation score from -100 to +100. Lower is worse.'}, 'address': {'type': 'string', 'description': 'The screened address'}, 'summary': {'type': 'string', 'description': 'One line verdict headline'}, 'bandCode': {'type': 'string', 'description': 'Band identifier, e.g. LOW_RISK, REPUTABLE'}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'factor', 'severity', 'message'], 'properties': {'code': {'type': 'string', 'description': 'Stable code for this signal, e.g. OUTBOUND_DUST_SPRAY'}, 'factor': {'type': 'string', 'description': 'Category of the signal, e.g. Behaviour Patterns'}, 'message': {'type': 'string', 'description': 'Short description of the signal'}, 'severity': {'enum': ['High', 'Medium', 'Low'], 'type': 'string'}}, 'additionalProperties': False}, 'description': 'Up to 10 signals behind the verdict, most severe first'}, 'reportUrl': {'type': 'string', 'description': 'Link to the full report on the Probity dashboard'}, 'confidence': {'enum': ['High', 'Medium', 'Low'], 'type': 'string', 'description': 'Engine confidence in the result'}, 'sanctioned': {'type': 'boolean', 'description': 'True if the address is a direct OFAC match'}, 'screenedAt': {'type': 'string', 'description': 'When the screen ran (ISO-8601)'}, 'screeningId': {'type': 'string', 'description': 'Immutable identifier for this screen (rsr_...)'}, 'transactionCount': {'type': 'integer', 'description': 'Number of transactions analysed'}}, 'additionalProperties': False}