# Create Address

<mark style="color:yellow;">`POST`</mark> `/api/v2/analytics/chains/{chain}/addresses/{address}`\
\
This endpoint provides multiple functionalities for managing wallet addresses:<br>

* 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.

<mark style="color:orange;">`bitcoin`</mark>, <mark style="color:orange;">`ethereum`</mark>, <mark style="color:orange;">`litecoin`</mark>, <mark style="color:orange;">`bitcoin-cash`</mark>, <mark style="color:orange;">`doge`</mark>, <mark style="color:orange;">`solana`</mark>, <mark style="color:orange;">`xdc`</mark>, <mark style="color:orange;">`ripple`</mark>, <mark style="color:orange;">`stellar`</mark>, <mark style="color:orange;">`algorand`</mark>, <mark style="color:orange;">`polygon`</mark>, <mark style="color:orange;">`polkadot`</mark>, <mark style="color:orange;">`tezos`</mark>, <mark style="color:orange;">`near`</mark>.

Path Parameters

| Name      | Type   | Description                                                                                                    | Required |
| --------- | ------ | -------------------------------------------------------------------------------------------------------------- | -------- |
| `chain`   | string | Blockchain network name. Example: <mark style="color:orange;">`bitcoin`</mark>                                 | True     |
| `address` | string | Unique blockchain identifier. Example: <mark style="color:orange;">`1JjYpRXfPntVEJqAjxsYmvFjjJBdJyaJ2k`</mark> | True     |

Request Body

| Name             | Type    | Description                                                                                                                                                                                               | Required |
| ---------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
| `provider_name`  | string  | Name of the blockchain risk provider to use for screening. Examples: <mark style="color:orange;">`RDBIG`</mark> (Blockchain Intelligence Group), <mark style="color:orange;">`RDCFI`</mark> (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    |

## Self-Hosted, Account-Linked and Risk-Screened

Label an address as self-hosted, link it to an existing account, and perform risk screening using a blockchain analytics provider.

{% tabs %}
{% tab title="REQUEST" %}

```json
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", // blockchain risk provider
	"is_self_hosted": true, // true or false
	"scan_for_risk": true, // true or false
	"account_ref_id": "CUSTOMER-234923423" 
}'
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="RESPONSE" %}

```json
{
    "status": "success",
    "data": {
        "address": "1Edue8XZCWNoDBNZgnQkCCivDyr9GEo4x6",
        "chain": "bitcoin",
        "symbol": "BTC",
        "is_self_hosted": true,
        "financial_data": {
            "balance": 0.0,
            "balance_usd": 0.0
        },
        "risk_data": [
            {
                "provider_name": "RDBIG",
                "risk_ratio": 100,
                "risk_descriptors": [
                    "Sanctioned OFAC"
                ],
                "vasp_name_legal": "",
                "vasp_name_business": "Binance,Suex.io,nexo,cryptox,",
                "vasp_website": null,
                "vasp_category": "exchange,exchange,exchange,exchange,",
                "created": "2025-04-15T17:30:38.019344"
            }
        ],
        "created": "2025-04-15T17:30:38.019344"
    },
    "message": null
}
```

{% endtab %}
{% endtabs %}

## Self-Hosted, and Account-Linked

Label an address as self-hosted, and link it to an existing account

{% tabs %}
{% tab title="REQUEST" %}

```json
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, // true or false
    "scan_for_risk": false, // true or false
    "account_ref_id": "CUSTOMER-234923423"
}' 
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="RESPONSE" %}

```json
{
    "status": "success",
    "data": {
        "address": "1Edue8XZCWNoDBNZgnQkCCivDyr9GEo4x6",
        "chain": "bitcoin",
        "symbol": "BTC",
        "is_self_hosted": true,
        "financial_data": {
            "balance": 0.0,
            "balance_usd": 0.0
        },
        "risk_data": null,
        "created": "2025-04-15T17:30:38.097294+00:00"
    },
    "message": null
}
```

{% endtab %}
{% endtabs %}