---
# System prepended metadata

title: Retrieve Attribution from API

---

# Retrieve Attribution from API

Here's a link to a video on how you can retreive API documentation and API keys you would need for the integration. https://www.loom.com/share/376616c9961f49748b829f23c00e0b58

The default rate limits applied to your account will be 100 / second, 1000 / hour and 10000 per day

The API you would need to use is the Create or View API under the Address section of the API Documentation

Once you submit an API request (parameters required are address-identifier, currency code and API Key) for the request, you will receive a JSON response. In this response look for tags key, which in turn contains 'user' and 'owner' keys.

Owner: (This key contains attribution information for the owner of an address) - tag_name_verbose: Name of entity - tag_type_verbose: One of 17 types we classify entities into (Ex: Exchange, Darknet, etc) - tag_subtype_verbose: One of 60+ subtype we classify entities into (Ex: Exchange: Mandatory KYC, etc)

User: (This key contains attribution information for the user of an address, for example a User on Binance) - tag_name_verbose: Name of User entity - tag_type_verbose: One of 17 types we classify entities into (Ex: Exchange, Darknet, etc) - tag_subtype_verbose: One of 60+ subtype we classify entities into (Ex: Exchange: Mandatory KYC, etc)

Sample CURL Request for an Address with Owner Tag:
```
curl --request POST \ --url https://demo.api.merklescience.com/api/v3/addresses/ \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'X-API-KEY: 7GMBE6RYY0QFMLE6OHQBAZVCNZ2N9FQJX5X69JU1C3' \ --data ' { "identifier": "0xd551234ae421e3bcba99a0da6d736074f22192ff", "currency": "1" } '
```
