Create Address

POST /api/v2/analytics/chains/{chain}/addresses/{address} This endpoint provides multiple functionalities for managing wallet addresses:

  • Enable wallet address screening using alternative blockchain analytics providers. In this case, scan_for_risk must be set to "true", and provider_name is required. Note: The available blockchain analytics provider may vary depending on your plan and activation settings.

  • Load a wallet address into the system without screening by setting scan_for_risk to "false".

  • Associate a wallet address with an existing account by specifying the account_ref_id.

  • Label a wallet address as a self-hosted wallet by setting is_self_hosted to "true". To use this endpoint, you must provide the wallet address hash and the blockchain network.

bitcoin, ethereum, litecoin, bitcoin-cash, doge, solana, xdc, ripple, stellar, algorand, polygon, polkadot, tezos, near.

Path Parameters

Name
Type
Description
Required

chain

string

Blockchain network name. Example: bitcoin

True

address

string

Unique blockchain identifier. Example: 1JjYpRXfPntVEJqAjxsYmvFjjJBdJyaJ2k

True

Request Body

Name
Type
Description
Required

provider_name

string

Name of the blockchain risk provider to use for screening. Examples: RDBIG (Blockchain Intelligence Group), RDCFI (Lukka, Inc.)

False

is_self_hosted

boolean

Indicates if the wallet address is self-hosted. Defaults to "false".

False

scan_for_risk

boolean

Whether to initiate a risk scan for the provided address. Defaults to "false".

False

account_ref_id

string

Reference ID of the account to associate with this wallet address.

False

Sample Requests

curl -X POST https://sandbox.ospree.io/api/v2/analytics/chains/bitcoin/addresses/1Edue8XZCWNoDBNZgnQkCCivDyr9GEo4x6

-h 'Content-Type: application/json' \
-h 'Accept: application/json' \
-h 'Authorization: ••••••' \
-d '{
	"provider_name": "RDBIG",
	"is_self_hosted": false,
	"scan_for_risk": true,
	"account_ref_id": "kxfIhp8ud8"
}'
curl -X POST https://sandbox.ospree.io/api/v2/analytics/chains/bitcoin/addresses/1Edue8XZCWNoDBNZgnQkCCivDyr9GEo4x6

-h 'Content-Type: application/json' \
-h 'Accept: application/json' \
-h 'Authorization: ••••••' \
-d '{
    "is_self_hosted": true,
    "scan_for_risk": false,
    "account_ref_id": "kxfIhp8ud8"
}' 

Last updated