> For the complete documentation index, see [llms.txt](https://docs.cielo.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cielo.finance/api-reference/tags.md).

# Tags

Wallet labels such as high win rate, gem finder, sniper or MEV, and the wallets that carry a given tag.

## Tags

> \# This endpoint is deprecated. Please use the \`/api/v1/tags\` endpoint instead.\
> This endpoint retrieves tags associated with a specific wallet address. Tags provide insights into wallet activity, such as NFT trading volume or participation in DeFi protocols.\
> \### Cost per Request\
> Cost per request = 5 credits.\
> \### Available Plans\
> Available on the following plans:\
> \- Builder\
> \- Architect\
> \- Enterprise<br>

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"tags":[{"name":"Tags","description":"Wallet labels such as high win rate, gem finder, sniper or MEV, and the wallets that carry a given tag."}],"servers":[{"url":"https://api.cielo.finance","description":"Endpoint"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","in":"header","name":"X-API-KEY"}},"responses":{"TagsResponse":{"description":"Successfull Tags response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tags"}}}}},"schemas":{"Tags":{"type":"object","description":"The response schema for the /v1/{wallet}/tags endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains the main data of the response.","properties":{"tags":{"type":"array","description":"An array of tags associated with the wallet address.","items":{"$ref":"#/components/schemas/TagModel"}}}},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"TagModel":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/TagTypes","description":"A unique identifier for the tag."},"tag":{"type":"string","description":"The tag label or name."},"description":{"type":"string","description":"A description of what the tag represents."}},"required":["key","tag","description"]},"TagTypes":{"type":"string","enum":["high_volume_dex_trader","early_defi","multichain","new_wallet","high_leverage_trader","nft_trader","nftfi","nft_high_pnl","popular_wallet","airdrop_hunter","gem_finder","high_win_rate","new_whale","flipper","honeypot","mev","sniper"]},"ErrorResponse":{"type":"object","description":"This object represents a response structure typically used to convey the outcome of a request. It primarily consists of a status indicator and a message, which together provide essential feedback about the request's processing. The status reflects the overall result of the request (such as success, error, etc.), while the message gives a more detailed explanation or the nature of the response, especially useful in cases of errors or exceptions.\n","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the response status object. This status is a key indicator of whether the request was processed successfully or resulted in an error."},"data":{"type":"object","description":"A flexible object intended to hold the actual data payload of the response. The structure of this object can vary depending on the specific endpoint and the nature of the response."},"message":{"type":"string","description":"A descriptive message providing additional details about the response. In case of an error, this message typically contains information useful for understanding the error's cause or nature."}},"required":["status","message"]}}},"paths":{"/api/v1/{wallet}/tags":{"get":{"tags":["Tags"],"summary":"Tags","deprecated":true,"description":"# This endpoint is deprecated. Please use the `/api/v1/tags` endpoint instead.\nThis endpoint retrieves tags associated with a specific wallet address. Tags provide insights into wallet activity, such as NFT trading volume or participation in DeFi protocols.\n### Cost per Request\nCost per request = 5 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n","operationId":"getWalletTags","parameters":[{"name":"wallet","in":"path","description":"Get tags associated with wallet.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/TagsResponse"},"400":{"description":"Bad Request - The request was unacceptable, often due to missing a required parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden - The client does not have access rights to the content.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error - Something went wrong on the server's end.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Wallets Tags

> This endpoint retrieves tags associated with a specific wallet address.  Tags provide insights into wallet activity.\
> Note, tags will only be returned for wallets indexed by the Cielo engine.\
> \### Cost per Request\
> Cost per request = 5 credits.\
> \### Available Plans\
> Available on the following plans:\
> \- Builder\
> \- Architect\
> \- Enterprise<br>

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"tags":[{"name":"Tags","description":"Wallet labels such as high win rate, gem finder, sniper or MEV, and the wallets that carry a given tag."}],"servers":[{"url":"https://api.cielo.finance","description":"Endpoint"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","in":"header","name":"X-API-KEY"}},"schemas":{"WalletsTags":{"type":"object","description":"The response schema for the /v1/tags endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"array","description":"Contains the main data of the response.","items":{"type":"object","properties":{"wallet":{"type":"string","description":"The wallet address associated with the tags."},"tags":{"$ref":"#/components/schemas/TagModel"}}}},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"TagModel":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/TagTypes","description":"A unique identifier for the tag."},"tag":{"type":"string","description":"The tag label or name."},"description":{"type":"string","description":"A description of what the tag represents."}},"required":["key","tag","description"]},"TagTypes":{"type":"string","enum":["high_volume_dex_trader","early_defi","multichain","new_wallet","high_leverage_trader","nft_trader","nftfi","nft_high_pnl","popular_wallet","airdrop_hunter","gem_finder","high_win_rate","new_whale","flipper","honeypot","mev","sniper"]},"ErrorResponse":{"type":"object","description":"This object represents a response structure typically used to convey the outcome of a request. It primarily consists of a status indicator and a message, which together provide essential feedback about the request's processing. The status reflects the overall result of the request (such as success, error, etc.), while the message gives a more detailed explanation or the nature of the response, especially useful in cases of errors or exceptions.\n","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the response status object. This status is a key indicator of whether the request was processed successfully or resulted in an error."},"data":{"type":"object","description":"A flexible object intended to hold the actual data payload of the response. The structure of this object can vary depending on the specific endpoint and the nature of the response."},"message":{"type":"string","description":"A descriptive message providing additional details about the response. In case of an error, this message typically contains information useful for understanding the error's cause or nature."}},"required":["status","message"]}}},"paths":{"/api/v1/tags":{"get":{"tags":["Tags"],"summary":"Wallets Tags","description":"This endpoint retrieves tags associated with a specific wallet address.  Tags provide insights into wallet activity.\nNote, tags will only be returned for wallets indexed by the Cielo engine.\n### Cost per Request\nCost per request = 5 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n","operationId":"getWalletsTags","parameters":[{"name":"wallet","in":"query","description":"Get tags associated with wallets in the list. Maximum of 50 wallets.","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"Successfull Wallets Tags response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletsTags"}}}},"400":{"description":"Bad Request - The request was unacceptable, often due to missing a required parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden - The client does not have access rights to the content.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error - Something went wrong on the server's end.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Wallets by Tag

> This endpoint retrieves wallets associated with a specific tag. Tags provide insights into wallet activity.\
> \### Cost per Request\
> Cost per request = 10 credits.\
> \### Available Plans\
> Available on the following plans:\
> \- Builder\
> \- Architect\
> \- Enterprise<br>

```json
{"openapi":"3.0.0","info":{"title":"Cielo Public API","version":"1.0"},"tags":[{"name":"Tags","description":"Wallet labels such as high win rate, gem finder, sniper or MEV, and the wallets that carry a given tag."}],"servers":[{"url":"https://api.cielo.finance","description":"Endpoint"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","in":"header","name":"X-API-KEY"}},"schemas":{"TagTypes":{"type":"string","enum":["high_volume_dex_trader","early_defi","multichain","new_wallet","high_leverage_trader","nft_trader","nftfi","nft_high_pnl","popular_wallet","airdrop_hunter","gem_finder","high_win_rate","new_whale","flipper","honeypot","mev","sniper"]},"WalletsByTag":{"type":"object","description":"The response schema for the /v1/tags/wallets endpoint.","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the standard response status object, which indicates the success or failure of the API request."},"data":{"type":"object","description":"Contains the main data of the response.","properties":{"items":{"type":"array","description":"An array of related wallets associated with the wallet address.","items":{"type":"object","properties":{"wallet":{"type":"string","description":"The wallet address for a wallet with the provided tags."},"wallet_type":{"type":"string","enum":["evm","solana"],"description":"The wallet type for the wallet returned."}}}},"paging":{"type":"object","description":"Provides details about pagination, indicating the total number of rows on the current page, whether a next page exists, and the identifier for the next object.","properties":{"next_page":{"type":"string","description":"An identifier for the next page, used for pagination purposes."},"has_next_page":{"type":"boolean","description":"Indicates whether a next page exists."}},"required":["has_next_page"]}},"required":["items","paging"]},"message":{"type":"string","description":"A descriptive message accompanying the response, often used to provide additional information or context about the results or the status of the request."}},"required":["status","data"]},"ResponseStatus":{"type":"string","enum":["ok","error","pending"]},"ErrorResponse":{"type":"object","description":"This object represents a response structure typically used to convey the outcome of a request. It primarily consists of a status indicator and a message, which together provide essential feedback about the request's processing. The status reflects the overall result of the request (such as success, error, etc.), while the message gives a more detailed explanation or the nature of the response, especially useful in cases of errors or exceptions.\n","properties":{"status":{"$ref":"#/components/schemas/ResponseStatus","description":"A reference to the response status object. This status is a key indicator of whether the request was processed successfully or resulted in an error."},"data":{"type":"object","description":"A flexible object intended to hold the actual data payload of the response. The structure of this object can vary depending on the specific endpoint and the nature of the response."},"message":{"type":"string","description":"A descriptive message providing additional details about the response. In case of an error, this message typically contains information useful for understanding the error's cause or nature."}},"required":["status","message"]}},"responses":{"WalletsByTagResponse":{"description":"Successfull Wallets by Tag response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletsByTag"}}}}}},"paths":{"/api/v1/tags/wallets":{"get":{"tags":["Tags"],"summary":"Wallets by Tag","description":"This endpoint retrieves wallets associated with a specific tag. Tags provide insights into wallet activity.\n### Cost per Request\nCost per request = 10 credits.\n### Available Plans\nAvailable on the following plans:\n- Builder\n- Architect\n- Enterprise\n","operationId":"getWalletsByTag","parameters":[{"name":"tags","in":"query","description":"Filter wallets by a specific tag.","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/TagTypes"}}},{"name":"wallet_type","in":"query","description":"Filter wallets by a specific wallet type.","required":false,"schema":{"type":"string","enum":["evm","solana"]}},{"name":"limit","in":"query","description":"The number of wallets to return. The default is 20. The maximum value is 50.","required":false,"schema":{"type":"integer"}},{"name":"next_object","in":"query","description":"Next page for pagination.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"$ref":"#/components/responses/WalletsByTagResponse"},"400":{"description":"Bad Request - The request was unacceptable, often due to missing a required parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden - The client does not have access rights to the content.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error - Something went wrong on the server's end.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
