Guarda una etiqueta privada sobre una dirección EVM. Sin X-Case-Id, la etiqueta es de su clave de API (o de su
usuario, desde la app); con X-Case-Id, del caso. Solo la ven los pedidos con ese alcance, nunca otros clientes.
Cuerpo del pedido. Un objeto Label con address (0x + 40 hex), chain, label, category, source
y confidence. Para que una etiqueta aportada no se presente como otra fuente, el servidor fija o limita estos
campos:
added_by y method se guardan siempre como "user" y "heuristic".
source se guarda como "usuario: <texto>", en una línea y con hasta 200 caracteres.
confidence: número entre 0 y 1 (por defecto 0.5), guardado con un máximo de 0.5, por debajo de cualquier
otra fuente.
category: bridge, contract, darknet, exchange, mixer, scam, unknown o victim. sanctioned
y ex_sanctioned están reservadas: una sanción proviene solo de las listas oficiales.
service_type, conflicting_tags y sanctions_history se guardan vacíos.
Respuesta.{"ok": true, "address": …, "label": {…}, "scope": {…}}, con la etiqueta tal como quedó guardada
y el alcance con que se guardó.
Errores.400 si la dirección no es EVM, si la categoría está reservada o no es válida, si confidence
está fuera de rango, o si X-Case-Id no corresponde a un caso que usted pueda editar (la etiqueta no se guarda).
422 si un campo no tiene la forma esperada.
Caso al que se agrega la etiqueta, opcional: el token de un caso que usted puede editar. Sin este header, la etiqueta queda para su clave de API. Un caso que no existe o que usted no puede editar responde 400 y la etiqueta no se guarda.
Cuerpo
application/json
address
string
requerido
label
string
requerido
chain
string
predeterminado:ethereum
category
string
predeterminado:unknown
source
string
predeterminado:""
confidence
number
predeterminado:0.5
method
string
predeterminado:heuristic
added_by
string
predeterminado:seed
service_type
enum<string> | null
Opciones disponibles:
instant-exchanger,
privacy-pool,
deposit-address
conflicting_tags
ConflictingTag · object[]
Show child attributes
sanctions_history
SanctionsEvent · object[]
Show child attributes
chain_basis
LabelChainBasis · object | null
Por qué una label publicada para OTRA chain (origin_chain = Label.chain) aparece en la chain
de la consulta (applied_chain). Lo pone el server al leer el índice (labels.for_chain); ninguna
fuente ni cliente lo escribe. Sin este campo, la label es de la misma chain de la consulta (o de
usuario, que vale en toda chain).
• same_key: la address es una EOA medida (tiene clave), y la clave es la misma en toda chain
EVM: la label se aplica acá como INFERENCIA declarada, con su categoría.
• designation: la lista OFAC designa la address (y sus bajas la fechan): vale en toda chain EVM.
• not_applied: contrato, cuenta sin prueba de clave o sin medir en su origen: en esta chain la
misma address puede ser otra cosa, así que la label viaja como context (peso 0) y el nodo toma
nombre y categoría de su propia chain.
Show child attributes
entity
EntityRef · object | null
La entidad regional a la que pertenece la MARCA de una label (ver el bloque de arriba).
Show child attributes
observed_at
string | null
observed_basis
enum<string> | null
Opciones disponibles:
source_row,
source_snapshot,
source_commit,
measured,
analyst,
none
valid_until
string | null
validity
enum<string> | null
Opciones disponibles:
not_declared,
ended,
live
license
LabelLicense · object | null
La licencia de la FUENTE de una label (registro attribution/provenance.py, por added_by): qué licencia es,
si permite el uso comercial y si el dato va en un entregable. None en la label = no consta.
Show child attributes
Respuesta
Respuesta correcta.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"blockgence","colors":{"primary":"#2f6fb0","light":"#7aa7d9","dark":"#2f6fb0"},"logo":{"light":"https://mintcdn.com/blockgence/hQoQZw1-fxGoNXIk/logo/light.svg?fit=max\u0026auto=format\u0026n=hQoQZw1-fxGoNXIk\u0026q=85\u0026s=64dd57006cc9a05bfded0f58fd024838","dark":"https://mintcdn.com/blockgence/hQoQZw1-fxGoNXIk/logo/dark.svg?fit=max\u0026auto=format\u0026n=hQoQZw1-fxGoNXIk\u0026q=85\u0026s=a45de9566b24e7fcfc2eb1e8bf016633","href":"https://www.blockgence.com"},"favicon":"https://mintcdn.com/blockgence/hQoQZw1-fxGoNXIk/favicon.svg?fit=max\u0026auto=format\u0026n=hQoQZw1-fxGoNXIk\u0026q=85\u0026s=c94376d013d15f2c5197929f8bceef65","api":{"playground":{"display":"interactive"}},"appearance":{"default":"dark"},"background":{"color":{"light":"#f4f5f7","dark":"#0e1013"}},"navbar":{"primary":{"type":"button","label":"app.blockgence.com","href":"https://app.blockgence.com"}},"footer":{"socials":{"website":"https://www.blockgence.com"}},"seo":{"metatags":{"og:site_name":"blockgence"}},"fonts":{"family":"IBM Plex Sans"},"styling":{"latex":false},"navigation":{"languages":[{"language":"es","default":true,"href":"es/get-started/introduction"},{"language":"en","href":"en/get-started/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"blockgence","hasAudioNarration":false,"actualSubdomain":"blockgence","customDomains":["docs.blockgence.com"],"gitSource":{"type":"github","owner":"santinopuglia","repo":"blockgence-api","deployBranch":"main","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":"","_id":"6b0106858f4c984fe1cf7504"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b01182d255b3a7aa79ca958","clientVersion":"0.0.4269","searchFilterCounts":[{"language":"en","tag":"API","count":141},{"language":"es","tag":"API","count":141},{"language":"en","tag":"Reference","count":137},{"language":"es","tag":"Referencia","count":137},{"language":"en","tag":"Cases","count":28},{"language":"es","tag":"Casos","count":28},{"language":"en","tag":"Guard","count":26},{"language":"es","tag":"Guard","count":26},{"language":"en","tag":"Incidents","count":22},{"language":"es","tag":"Incidentes","count":22},{"language":"en","tag":"Tracing","count":21},{"language":"es","tag":"Rastreo","count":21},{"language":"en","tag":"Methodology and evidence","count":10},{"language":"es","tag":"Metodología y evidencia","count":10},{"language":"en","tag":"Audit","count":9},{"language":"es","tag":"Auditoría","count":9},{"language":"en","tag":"Get started","count":8},{"language":"en","tag":"Products","count":8},{"language":"es","tag":"Empezar","count":8},{"language":"es","tag":"Productos","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"es/api-reference/post-v1-labels","slug":"/es/api-reference/post-v1-labels","pageMetadata":{"title":"Aportar una etiqueta privada","description":"Guarda una etiqueta privada sobre una dirección EVM. Sin `X-Case-Id`, la etiqueta es de su clave de API (o de su\nusuario, desde la app); con `X-Case-Id`, del caso. Solo la ven los pedidos con ese alcance, nunca otros clientes.\n\n**Cuerpo del pedido.** Un objeto `Label` con `address` (`0x` + 40 hex), `chain`, `label`, `category`, `source`\ny `confidence`. Para que una etiqueta aportada no se presente como otra fuente, el servidor fija o limita estos\ncampos:\n- `added_by` y `method` se guardan siempre como `\"user\"` y `\"heuristic\"`.\n- `source` se guarda como `\"usuario: \u003ctexto>\"`, en una línea y con hasta 200 caracteres.\n- `confidence`: número entre 0 y 1 (por defecto 0.5), guardado con un máximo de 0.5, por debajo de cualquier\n otra fuente.\n- `category`: `bridge`, `contract`, `darknet`, `exchange`, `mixer`, `scam`, `unknown` o `victim`. `sanctioned`\n y `ex_sanctioned` están reservadas: una sanción proviene solo de las listas oficiales.\n- `service_type`, `conflicting_tags` y `sanctions_history` se guardan vacíos.\n\n**Respuesta.** `{\"ok\": true, \"address\": …, \"label\": {…}, \"scope\": {…}}`, con la etiqueta tal como quedó guardada\ny el alcance con que se guardó.\n\n**Errores.** `400` si la dirección no es EVM, si la categoría está reservada o no es válida, si `confidence`\nestá fuera de rango, o si `X-Case-Id` no corresponde a un caso que usted pueda editar (la etiqueta no se guarda).\n`422` si un campo no tiene la forma esperada.\n\n**Costo:** 1 crédito.","deprecated":null,"version":null,"sidebarTitle":"Aportar una etiqueta privada","openapi":"/openapi.es.json post /v1/labels","href":"/es/api-reference/post-v1-labels","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Guarda una etiqueta privada sobre una dirección EVM. Sin \", _jsx(_components.code, {\n children: \"X-Case-Id\"\n }), \", la etiqueta es de su clave de API (o de su\\nusuario, desde la app); con \", _jsx(_components.code, {\n children: \"X-Case-Id\"\n }), \", del caso. Solo la ven los pedidos con ese alcance, nunca otros clientes.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Cuerpo del pedido.\"\n }), \" Un objeto \", _jsx(_components.code, {\n children: \"Label\"\n }), \" con \", _jsx(_components.code, {\n children: \"address\"\n }), \" (\", _jsx(_components.code, {\n children: \"0x\"\n }), \" + 40 hex), \", _jsx(_components.code, {\n children: \"chain\"\n }), \", \", _jsx(_components.code, {\n children: \"label\"\n }), \", \", _jsx(_components.code, {\n children: \"category\"\n }), \", \", _jsx(_components.code, {\n children: \"source\"\n }), \"\\ny \", _jsx(_components.code, {\n children: \"confidence\"\n }), \". Para que una etiqueta aportada no se presente como otra fuente, el servidor fija o limita estos\\ncampos:\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"added_by\"\n }), \" y \", _jsx(_components.code, {\n children: \"method\"\n }), \" se guardan siempre como \", _jsx(_components.code, {\n children: \"\\\"user\\\"\"\n }), \" y \", _jsx(_components.code, {\n children: \"\\\"heuristic\\\"\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"source\"\n }), \" se guarda como \", _jsx(_components.code, {\n children: \"\\\"usuario: \u003ctexto>\\\"\"\n }), \", en una línea y con hasta 200 caracteres.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"confidence\"\n }), \": número entre 0 y 1 (por defecto 0.5), guardado con un máximo de 0.5, por debajo de cualquier\\notra fuente.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"category\"\n }), \": \", _jsx(_components.code, {\n children: \"bridge\"\n }), \", \", _jsx(_components.code, {\n children: \"contract\"\n }), \", \", _jsx(_components.code, {\n children: \"darknet\"\n }), \", \", _jsx(_components.code, {\n children: \"exchange\"\n }), \", \", _jsx(_components.code, {\n children: \"mixer\"\n }), \", \", _jsx(_components.code, {\n children: \"scam\"\n }), \", \", _jsx(_components.code, {\n children: \"unknown\"\n }), \" o \", _jsx(_components.code, {\n children: \"victim\"\n }), \". \", _jsx(_components.code, {\n children: \"sanctioned\"\n }), \"\\ny \", _jsx(_components.code, {\n children: \"ex_sanctioned\"\n }), \" están reservadas: una sanción proviene solo de las listas oficiales.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"service_type\"\n }), \", \", _jsx(_components.code, {\n children: \"conflicting_tags\"\n }), \" y \", _jsx(_components.code, {\n children: \"sanctions_history\"\n }), \" se guardan vacíos.\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Respuesta.\"\n }), \" \", _jsx(_components.code, {\n children: \"{\\\"ok\\\": true, \\\"address\\\": …, \\\"label\\\": {…}, \\\"scope\\\": {…}}\"\n }), \", con la etiqueta tal como quedó guardada\\ny el alcance con que se guardó.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Errores.\"\n }), \" \", _jsx(_components.code, {\n children: \"400\"\n }), \" si la dirección no es EVM, si la categoría está reservada o no es válida, si \", _jsx(_components.code, {\n children: \"confidence\"\n }), \"\\nestá fuera de rango, o si \", _jsx(_components.code, {\n children: \"X-Case-Id\"\n }), \" no corresponde a un caso que usted pueda editar (la etiqueta no se guarda).\\n\", _jsx(_components.code, {\n children: \"422\"\n }), \" si un campo no tiene la forma esperada.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Costo:\"\n }), \" 1 crédito.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Aportar una etiqueta privada","description":"Guarda una etiqueta privada sobre una dirección EVM. Sin `X-Case-Id`, la etiqueta es de su clave de API (o de su\nusuario, desde la app); con `X-Case-Id`, del caso. Solo la ven los pedidos con ese alcance, nunca otros clientes.\n\n**Cuerpo del pedido.** Un objeto `Label` con `address` (`0x` + 40 hex), `chain`, `label`, `category`, `source`\ny `confidence`. Para que una etiqueta aportada no se presente como otra fuente, el servidor fija o limita estos\ncampos:\n- `added_by` y `method` se guardan siempre como `\"user\"` y `\"heuristic\"`.\n- `source` se guarda como `\"usuario: \u003ctexto>\"`, en una línea y con hasta 200 caracteres.\n- `confidence`: número entre 0 y 1 (por defecto 0.5), guardado con un máximo de 0.5, por debajo de cualquier\n otra fuente.\n- `category`: `bridge`, `contract`, `darknet`, `exchange`, `mixer`, `scam`, `unknown` o `victim`. `sanctioned`\n y `ex_sanctioned` están reservadas: una sanción proviene solo de las listas oficiales.\n- `service_type`, `conflicting_tags` y `sanctions_history` se guardan vacíos.\n\n**Respuesta.** `{\"ok\": true, \"address\": …, \"label\": {…}, \"scope\": {…}}`, con la etiqueta tal como quedó guardada\ny el alcance con que se guardó.\n\n**Errores.** `400` si la dirección no es EVM, si la categoría está reservada o no es válida, si `confidence`\nestá fuera de rango, o si `X-Case-Id` no corresponde a un caso que usted pueda editar (la etiqueta no se guarda).\n`422` si un campo no tiene la forma esperada.\n\n**Costo:** 1 crédito.","deprecated":null,"version":null,"sidebarTitle":"Aportar una etiqueta privada","openapi":"/openapi.es.json post /v1/labels","href":"/es/api-reference/post-v1-labels","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Rastreo"],"summary":"Aportar una etiqueta privada","description":"Guarda una etiqueta privada sobre una dirección EVM. Sin `X-Case-Id`, la etiqueta es de su clave de API (o de su\nusuario, desde la app); con `X-Case-Id`, del caso. Solo la ven los pedidos con ese alcance, nunca otros clientes.\n\n**Cuerpo del pedido.** Un objeto `Label` con `address` (`0x` + 40 hex), `chain`, `label`, `category`, `source`\ny `confidence`. Para que una etiqueta aportada no se presente como otra fuente, el servidor fija o limita estos\ncampos:\n- `added_by` y `method` se guardan siempre como `\"user\"` y `\"heuristic\"`.\n- `source` se guarda como `\"usuario: \u003ctexto>\"`, en una línea y con hasta 200 caracteres.\n- `confidence`: número entre 0 y 1 (por defecto 0.5), guardado con un máximo de 0.5, por debajo de cualquier\n otra fuente.\n- `category`: `bridge`, `contract`, `darknet`, `exchange`, `mixer`, `scam`, `unknown` o `victim`. `sanctioned`\n y `ex_sanctioned` están reservadas: una sanción proviene solo de las listas oficiales.\n- `service_type`, `conflicting_tags` y `sanctions_history` se guardan vacíos.\n\n**Respuesta.** `{\"ok\": true, \"address\": …, \"label\": {…}, \"scope\": {…}}`, con la etiqueta tal como quedó guardada\ny el alcance con que se guardó.\n\n**Errores.** `400` si la dirección no es EVM, si la categoría está reservada o no es válida, si `confidence`\nestá fuera de rango, o si `X-Case-Id` no corresponde a un caso que usted pueda editar (la etiqueta no se guarda).\n`422` si un campo no tiene la forma esperada.\n\n**Costo:** 1 crédito.","operationId":"add_label_v1_labels_post","security":["bf6449d6-2aef-4fca-b852-835aa59701c1","8564f5c3-9415-44db-857c-97ef375dc31b"],"parameters":["b2c103bf-d117-4abd-a6dd-a950c5790da7"],"requestBody":"5a199b3f-face-4500-8d9f-0caa6790c3d2","responses":{"200":"5cfe5160-5a5d-448f-bccb-fe44cc4b9bec","401":"3b273b88-4195-48a5-93e8-9100590f6c07","402":"71e5e500-3aa4-4ae0-9aca-a97a04983234","422":"3d60702d-0759-4131-a271-c722af36d3ce","429":"0a87a5cf-f6ba-4ed8-8215-84cf9e0a140d","503":"4072dd1b-a3df-439b-b84d-4c7d3334a84c"},"x-credits":1,"x-mint":{"href":"/es/api-reference/post-v1-labels","metadata":{"sidebarTitle":"Aportar una etiqueta privada"}},"method":"post","type":"path","servers":["bc197a59-5fb5-45ca-8a5d-a02d2803f4ff"],"path":"/v1/labels","baseUrlOptions":["https://app.blockgence.com"],"title":"Aportar una etiqueta privada","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b2c103bf-d117-4abd-a6dd-a950c5790da7":{"name":"X-Case-Id","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"X-Case-Id","description":"Caso al que se agrega la etiqueta, opcional: el token de un caso que usted puede editar. Sin este header, la etiqueta queda para su clave de API. Un caso que no existe o que usted no puede editar responde `400` y la etiqueta no se guarda.","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"X-Case-Id","description":"Caso al que se agrega la etiqueta, opcional: el token de un caso que usted puede editar. Sin este header, la etiqueta queda para su clave de API. Un caso que no existe o que usted no puede editar responde `400` y la etiqueta no se guarda.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Caso al que se agrega la etiqueta, opcional: el token de un caso que usted puede editar. Sin este header, la etiqueta queda para su clave de API. Un caso que no existe o que usted no puede editar responde `400` y la etiqueta no se guarda."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"address":{"type":"string","title":"Address","isRequired":true,"uniqueKey":"address","typeLabel":"string"},"label":{"type":"string","title":"Label","isRequired":true,"uniqueKey":"label","typeLabel":"string"},"chain":{"type":"string","title":"Chain","default":"ethereum","uniqueKey":"chain","typeLabel":"string"},"category":{"type":"string","title":"Category","default":"unknown","uniqueKey":"category","typeLabel":"string"},"source":{"type":"string","title":"Source","default":"","uniqueKey":"source","typeLabel":"string"},"confidence":{"type":"number","title":"Confidence","default":0.5,"uniqueKey":"confidence","typeLabel":"number"},"method":{"type":"string","title":"Method","default":"heuristic","uniqueKey":"method","typeLabel":"string"},"added_by":{"type":"string","title":"Added By","default":"seed","uniqueKey":"added_by","typeLabel":"string"},"service_type":{"oneOf":[{"type":"string","title":"Service Type","enum":["instant-exchanger","privacy-pool","deposit-address"],"uniqueKey":"service_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Service Type","uniqueKey":"service_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"service_type","typeLabel":"enum\u003cstring> | null"},"conflicting_tags":{"items":{"properties":{"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"conflicting_tags.items.[INDEX].name","typeLabel":"string"},"slug":{"type":"string","title":"Slug","default":"","uniqueKey":"conflicting_tags.items.[INDEX].slug","typeLabel":"string"},"tag_type":{"type":"string","title":"Tag Type","default":"","uniqueKey":"conflicting_tags.items.[INDEX].tag_type","typeLabel":"string"},"category":{"type":"string","title":"Category","default":"","uniqueKey":"conflicting_tags.items.[INDEX].category","typeLabel":"string"},"source":{"type":"string","title":"Source","default":"blockscout","uniqueKey":"conflicting_tags.items.[INDEX].source","typeLabel":"string"},"applied":{"type":"boolean","title":"Applied","default":false,"uniqueKey":"conflicting_tags.items.[INDEX].applied","typeLabel":"boolean"},"reason":{"type":"string","title":"Reason","default":"","uniqueKey":"conflicting_tags.items.[INDEX].reason","typeLabel":"string"}},"type":"object","required":["name"],"title":"ConflictingTag","description":"Tag de riesgo de un tercero que la clasificación NO aplicó a la `category`.\n\nGlass-box estructurado: antes estos tags viajaban solo como texto libre dentro de\n`Label.source` y el cliente no podía leerlos como dato. Caso típico: la hot wallet de\nFixedFloat trae los genéricos «Phish / Hack» y «Poisoning Address» junto al nombre de\nla entidad — el tag de identidad gana (`exchange`), pero el conflicto se muestra.\nNO mueve `category`, `risk.score` ni la recomendación: es contexto para ponderar.","uniqueKey":"conflicting_tags.items.[INDEX]","typeLabel":"ConflictingTag · object"},"type":"array","title":"Conflicting Tags","uniqueKey":"conflicting_tags","typeLabel":"ConflictingTag · object[]"},"sanctions_history":{"items":{"properties":{"authority":{"type":"string","title":"Authority","isRequired":true,"uniqueKey":"sanctions_history.items.[INDEX].authority","typeLabel":"string"},"list":{"type":"string","title":"List","isRequired":true,"uniqueKey":"sanctions_history.items.[INDEX].list","typeLabel":"string"},"action":{"type":"string","enum":["listed","delisted"],"title":"Action","isRequired":true,"uniqueKey":"sanctions_history.items.[INDEX].action","typeLabel":"enum\u003cstring>"},"source_url":{"type":"string","title":"Source Url","isRequired":true,"uniqueKey":"sanctions_history.items.[INDEX].source_url","typeLabel":"string"},"programs":{"items":{"type":"string","uniqueKey":"sanctions_history.items.[INDEX].programs.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Programs","uniqueKey":"sanctions_history.items.[INDEX].programs","typeLabel":"string[]"},"date":{"oneOf":[{"type":"string","title":"Date","uniqueKey":"sanctions_history.items.[INDEX].date.oneOf.0","typeLabel":"string"},{"type":"null","title":"Date","uniqueKey":"sanctions_history.items.[INDEX].date.oneOf.1","typeLabel":"null"}],"uniqueKey":"sanctions_history.items.[INDEX].date","typeLabel":"string | null"},"date_precision":{"type":"string","enum":["address","entity","unknown"],"title":"Date Precision","default":"unknown","uniqueKey":"sanctions_history.items.[INDEX].date_precision","typeLabel":"enum\u003cstring>"},"entity":{"type":"string","title":"Entity","default":"","uniqueKey":"sanctions_history.items.[INDEX].entity","typeLabel":"string"},"ref":{"type":"string","title":"Ref","default":"","uniqueKey":"sanctions_history.items.[INDEX].ref","typeLabel":"string"},"as_of":{"oneOf":[{"type":"string","title":"As Of","uniqueKey":"sanctions_history.items.[INDEX].as_of.oneOf.0","typeLabel":"string"},{"type":"null","title":"As Of","uniqueKey":"sanctions_history.items.[INDEX].as_of.oneOf.1","typeLabel":"null"}],"uniqueKey":"sanctions_history.items.[INDEX].as_of","typeLabel":"string | null"},"note":{"type":"string","title":"Note","default":"","uniqueKey":"sanctions_history.items.[INDEX].note","typeLabel":"string"}},"type":"object","required":["authority","list","action","source_url"],"title":"SanctionsEvent","description":"Un hecho fechado de una lista de sanciones sobre una dirección: alta (`listed`) o baja\n(`delisted`), con la autoridad, la lista, los programas y la fuente que lo publica.\n\nGlass-box: hasta el 2026-09-18 el historial viajaba como texto dentro de `Label.source` y el\nfront lo recuperaba con regex. `date_precision` dice QUÉ se fechó: OFAC publica en\nSDN_ADVANCED la fecha de alta de la ENTIDAD, no de cada dirección (Lazarus Group entró el\n2019-09-13 y la dirección de Ronin recién en la Recent Action del 2022-04-14), así que esa fecha\nes `entity` y no se puede leer como «la dirección está designada desde ese día».\n\nLo llenan solo las fuentes de sanciones: el seed de la lista OFAC vigente\n(`attribution/ofac_sdn.py`) y el registro de bajas (`attribution/sanctions.py`). Una label de\nusuario nunca lo trae (`labels._as_user_label` lo vacía).","uniqueKey":"sanctions_history.items.[INDEX]","typeLabel":"SanctionsEvent · object"},"type":"array","title":"Sanctions History","uniqueKey":"sanctions_history","typeLabel":"SanctionsEvent · object[]"},"chain_basis":{"oneOf":[{"type":"object","title":"LabelChainBasis","description":"Por qué una label publicada para OTRA chain (`origin_chain` = `Label.chain`) aparece en la chain\nde la consulta (`applied_chain`). Lo pone el server al leer el índice (`labels.for_chain`); ninguna\nfuente ni cliente lo escribe. Sin este campo, la label es de la misma chain de la consulta (o de\nusuario, que vale en toda chain).\n • `same_key`: la address es una EOA medida (tiene clave), y la clave es la misma en toda chain\n EVM: la label se aplica acá como INFERENCIA declarada, con su categoría.\n • `designation`: la lista OFAC designa la address (y sus bajas la fechan): vale en toda chain EVM.\n • `not_applied`: contrato, cuenta sin prueba de clave o sin medir en su origen: en esta chain la\n misma address puede ser otra cosa, así que la label viaja como `context` (peso 0) y el nodo toma\n nombre y categoría de su propia chain.","required":["origin_chain","applied_chain","basis"],"properties":{"origin_chain":{"type":"string","title":"Origin Chain","isRequired":true,"uniqueKey":"chain_basis.oneOf.0.origin_chain","typeLabel":"string"},"applied_chain":{"type":"string","title":"Applied Chain","isRequired":true,"uniqueKey":"chain_basis.oneOf.0.applied_chain","typeLabel":"string"},"basis":{"type":"string","enum":["same_key","designation","not_applied"],"title":"Basis","isRequired":true,"uniqueKey":"chain_basis.oneOf.0.basis","typeLabel":"enum\u003cstring>"},"account_type":{"type":"string","title":"Account Type","default":"","uniqueKey":"chain_basis.oneOf.0.account_type","typeLabel":"string"},"key_chain":{"type":"string","title":"Key Chain","default":"","uniqueKey":"chain_basis.oneOf.0.key_chain","typeLabel":"string"},"measured_block":{"oneOf":[{"type":"integer","title":"Measured Block","uniqueKey":"chain_basis.oneOf.0.measured_block.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Measured Block","uniqueKey":"chain_basis.oneOf.0.measured_block.oneOf.1","typeLabel":"null"}],"uniqueKey":"chain_basis.oneOf.0.measured_block","typeLabel":"integer | null"},"measured_at":{"type":"string","title":"Measured At","default":"","uniqueKey":"chain_basis.oneOf.0.measured_at","typeLabel":"string"},"note":{"type":"string","title":"Note","default":"","uniqueKey":"chain_basis.oneOf.0.note","typeLabel":"string"}},"uniqueKey":"chain_basis.oneOf.0","typeLabel":"LabelChainBasis · object"},{"type":"null","uniqueKey":"chain_basis.oneOf.1","typeLabel":"null"}],"uniqueKey":"chain_basis","typeLabel":"LabelChainBasis · object | null"},"entity":{"oneOf":[{"type":"object","title":"EntityRef","description":"La entidad regional a la que pertenece la MARCA de una label (ver el bloque de arriba).","required":["id","brand"],"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"entity.oneOf.0.id","typeLabel":"string"},"brand":{"type":"string","title":"Brand","isRequired":true,"uniqueKey":"entity.oneOf.0.brand","typeLabel":"string"},"kind":{"type":"string","title":"Kind","default":"exchange","uniqueKey":"entity.oneOf.0.kind","typeLabel":"string"},"countries":{"items":{"type":"string","uniqueKey":"entity.oneOf.0.countries.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Countries","uniqueKey":"entity.oneOf.0.countries","typeLabel":"string[]"},"registrations":{"items":{"properties":{"country":{"type":"string","title":"Country","isRequired":true,"uniqueKey":"entity.oneOf.0.registrations.items.[INDEX].country","typeLabel":"string"},"registry":{"type":"string","title":"Registry","isRequired":true,"uniqueKey":"entity.oneOf.0.registrations.items.[INDEX].registry","typeLabel":"string"},"registry_name":{"type":"string","title":"Registry Name","default":"","uniqueKey":"entity.oneOf.0.registrations.items.[INDEX].registry_name","typeLabel":"string"},"number":{"oneOf":[{"type":"integer","title":"Number","uniqueKey":"entity.oneOf.0.registrations.items.[INDEX].number.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Number","uniqueKey":"entity.oneOf.0.registrations.items.[INDEX].number.oneOf.1","typeLabel":"null"}],"uniqueKey":"entity.oneOf.0.registrations.items.[INDEX].number","typeLabel":"integer | null"},"legal_name":{"type":"string","title":"Legal Name","default":"","uniqueKey":"entity.oneOf.0.registrations.items.[INDEX].legal_name","typeLabel":"string"},"trade_name":{"type":"string","title":"Trade Name","default":"","uniqueKey":"entity.oneOf.0.registrations.items.[INDEX].trade_name","typeLabel":"string"},"tax_id":{"type":"string","title":"Tax Id","default":"","uniqueKey":"entity.oneOf.0.registrations.items.[INDEX].tax_id","typeLabel":"string"},"registered_at":{"type":"string","title":"Registered At","default":"","uniqueKey":"entity.oneOf.0.registrations.items.[INDEX].registered_at","typeLabel":"string"},"status":{"type":"string","enum":["listed","not_listed"],"title":"Status","default":"listed","uniqueKey":"entity.oneOf.0.registrations.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"basis":{"items":{"type":"string","uniqueKey":"entity.oneOf.0.registrations.items.[INDEX].basis.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Basis","uniqueKey":"entity.oneOf.0.registrations.items.[INDEX].basis","typeLabel":"string[]"},"checked_at":{"type":"string","title":"Checked At","default":"","uniqueKey":"entity.oneOf.0.registrations.items.[INDEX].checked_at","typeLabel":"string"},"source_url":{"type":"string","title":"Source Url","default":"","uniqueKey":"entity.oneOf.0.registrations.items.[INDEX].source_url","typeLabel":"string"},"review":{"type":"string","title":"Review","default":"","uniqueKey":"entity.oneOf.0.registrations.items.[INDEX].review","typeLabel":"string"}},"type":"object","required":["country","registry"],"title":"EntityRegistration","description":"Una inscripción de la marca en un registro público (hoy: Registro de PSAV de la CNV, Argentina).","uniqueKey":"entity.oneOf.0.registrations.items.[INDEX]","typeLabel":"EntityRegistration · object"},"type":"array","title":"Registrations","uniqueKey":"entity.oneOf.0.registrations","typeLabel":"EntityRegistration · object[]"},"basis":{"type":"string","enum":["label_name","registry_address"],"title":"Basis","default":"label_name","uniqueKey":"entity.oneOf.0.basis","typeLabel":"enum\u003cstring>"},"note":{"type":"string","title":"Note","default":"","uniqueKey":"entity.oneOf.0.note","typeLabel":"string"}},"uniqueKey":"entity.oneOf.0","typeLabel":"EntityRef · object"},{"type":"null","uniqueKey":"entity.oneOf.1","typeLabel":"null"}],"uniqueKey":"entity","typeLabel":"EntityRef · object | null"},"observed_at":{"oneOf":[{"type":"string","title":"Observed At","uniqueKey":"observed_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Observed At","uniqueKey":"observed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"observed_at","typeLabel":"string | null"},"observed_basis":{"oneOf":[{"type":"string","title":"Observed Basis","enum":["source_row","source_snapshot","source_commit","measured","analyst","none"],"uniqueKey":"observed_basis.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Observed Basis","uniqueKey":"observed_basis.oneOf.1","typeLabel":"null"}],"uniqueKey":"observed_basis","typeLabel":"enum\u003cstring> | null"},"valid_until":{"oneOf":[{"type":"string","title":"Valid Until","uniqueKey":"valid_until.oneOf.0","typeLabel":"string"},{"type":"null","title":"Valid Until","uniqueKey":"valid_until.oneOf.1","typeLabel":"null"}],"uniqueKey":"valid_until","typeLabel":"string | null"},"validity":{"oneOf":[{"type":"string","title":"Validity","enum":["not_declared","ended","live"],"uniqueKey":"validity.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Validity","uniqueKey":"validity.oneOf.1","typeLabel":"null"}],"uniqueKey":"validity","typeLabel":"enum\u003cstring> | null"},"license":{"oneOf":[{"type":"object","title":"LabelLicense","description":"La licencia de la FUENTE de una label (registro `attribution/provenance.py`, por `added_by`): qué licencia es,\nsi permite el uso comercial y si el dato va en un entregable. None en la label = no consta.","required":["name","status","commercial_use"],"properties":{"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"license.oneOf.0.name","typeLabel":"string"},"status":{"type":"string","enum":["ok","restricted","pending_review","not_licensed"],"title":"Status","isRequired":true,"uniqueKey":"license.oneOf.0.status","typeLabel":"enum\u003cstring>"},"commercial_use":{"type":"string","title":"Commercial Use","isRequired":true,"uniqueKey":"license.oneOf.0.commercial_use","typeLabel":"string"},"spdx":{"type":"string","title":"Spdx","default":"","uniqueKey":"license.oneOf.0.spdx","typeLabel":"string"},"packaged":{"type":"boolean","title":"Packaged","default":true,"uniqueKey":"license.oneOf.0.packaged","typeLabel":"boolean"},"url":{"type":"string","title":"Url","default":"","uniqueKey":"license.oneOf.0.url","typeLabel":"string"},"as_of":{"type":"string","title":"As Of","default":"","uniqueKey":"license.oneOf.0.as_of","typeLabel":"string"}},"uniqueKey":"license.oneOf.0","typeLabel":"LabelLicense · object"},{"type":"null","uniqueKey":"license.oneOf.1","typeLabel":"null"}],"uniqueKey":"license","typeLabel":"LabelLicense · object | null"}},"type":"object","required":["address","label"],"title":"Label","uniqueKey":"","typeLabel":"Label · object"},"examples":{"Example":{"title":"Example","value":{"address":"\u003cstring>","label":"\u003cstring>","chain":"ethereum","category":"unknown","source":"","confidence":0.5,"method":"heuristic","added_by":"seed","conflicting_tags":[{"name":"\u003cstring>","slug":"","tag_type":"","category":"","source":"blockscout","applied":false,"reason":""}],"sanctions_history":[{"authority":"\u003cstring>","list":"\u003cstring>","source_url":"\u003cstring>","programs":["\u003cstring>"],"date":"\u003cstring>","date_precision":"unknown","entity":"","ref":"","as_of":"\u003cstring>","note":""}],"chain_basis":{"origin_chain":"\u003cstring>","applied_chain":"\u003cstring>","account_type":"","key_chain":"","measured_block":123,"measured_at":"","note":""},"entity":{"id":"\u003cstring>","brand":"\u003cstring>","kind":"exchange","countries":["\u003cstring>"],"registrations":[{"country":"\u003cstring>","registry":"\u003cstring>","registry_name":"","number":123,"legal_name":"","trade_name":"","tax_id":"","registered_at":"","status":"listed","basis":["\u003cstring>"],"checked_at":"","source_url":"","review":""}],"basis":"label_name","note":""},"observed_at":"\u003cstring>","valid_until":"\u003cstring>","license":{"name":"\u003cstring>","commercial_use":"\u003cstring>","spdx":"","packaged":true,"url":"","as_of":""}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"5cfe5160-5a5d-448f-bccb-fe44cc4b9bec":{"description":"Respuesta correcta.","content":{"application/json":{"schema":{}}},"exampleType":"generated"},"3b273b88-4195-48a5-93e8-9100590f6c07":{"description":"Falta la clave de API, o es inválida o revocada.","content":{"application/json":{"schema":{"type":"object","title":"Error","description":"Forma común de los errores: un `detail` legible y, en muchos casos, un `error` con un código estable para reconocerlo sin interpretar el texto.","properties":{"detail":{"type":"string","description":"Qué ocurrió, en una frase.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"error":{"type":"string","description":"Código estable del error, cuando lo tiene.","uniqueKey":"error","typeLabel":"string"}},"required":["detail"],"uniqueKey":"","typeLabel":"Error · object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"71e5e500-3aa4-4ae0-9aca-a97a04983234":{"description":"Se agotaron los créditos del mes.","content":{"application/json":{"schema":{"type":"object","title":"Error","description":"Forma común de los errores: un `detail` legible y, en muchos casos, un `error` con un código estable para reconocerlo sin interpretar el texto.","properties":{"detail":{"type":"string","description":"Qué ocurrió, en una frase.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"error":{"type":"string","description":"Código estable del error, cuando lo tiene.","uniqueKey":"error","typeLabel":"string"}},"required":["detail"],"uniqueKey":"","typeLabel":"Error · object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"3d60702d-0759-4131-a271-c722af36d3ce":{"description":"El pedido no tiene la forma esperada; `detail` indica qué campo corregir.","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"0a87a5cf-f6ba-4ed8-8215-84cf9e0a140d":{"description":"Se superó el límite de pedidos por minuto. Reintente después de los segundos que indica `Retry-After`.","content":{"application/json":{"schema":{"type":"object","title":"Error","description":"Forma común de los errores: un `detail` legible y, en muchos casos, un `error` con un código estable para reconocerlo sin interpretar el texto.","properties":{"detail":{"type":"string","description":"Qué ocurrió, en una frase.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"error":{"type":"string","description":"Código estable del error, cuando lo tiene.","uniqueKey":"error","typeLabel":"string"}},"required":["detail"],"uniqueKey":"","typeLabel":"Error · object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4072dd1b-a3df-439b-b84d-4c7d3334a84c":{"description":"`source_unavailable`: la fuente de datos no pudo leer lo pedido. No se cobran créditos. Si falla un paso intermedio, la respuesta es 200 y lo declara en `degraded_sources`.","content":{"application/json":{"schema":{"type":"object","title":"SourceUnavailable","description":"La fuente de datos no pudo leer lo pedido. No se cobran créditos. La ausencia de datos no indica que la dirección esté libre de riesgo ni que no tenga movimientos.","properties":{"error":{"type":"string","enum":["source_unavailable"],"isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"detail":{"type":"string","description":"Qué falló, dónde y si conviene reintentar.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"source":{"type":"string","description":"Fuente que no pudo responder, por ejemplo `etherscan` o `blockscout`.","isRequired":true,"uniqueKey":"source","typeLabel":"string"},"reason":{"type":"string","description":"Motivo estable, por ejemplo `rate_limited`, `timeout` o `upstream_error`.","isRequired":true,"uniqueKey":"reason","typeLabel":"string"},"retryable":{"type":"boolean","isRequired":true,"uniqueKey":"retryable","typeLabel":"boolean"},"chain":{"type":"string","uniqueKey":"chain","typeLabel":"string"},"primitive":{"type":"string","description":"Lectura de blockgence que no se completó.","uniqueKey":"primitive","typeLabel":"string"},"operation":{"type":"string","description":"Consulta concreta a la fuente.","uniqueKey":"operation","typeLabel":"string"},"target":{"type":"string","description":"Lo consultado (dirección o transacción), abreviado.","uniqueKey":"target","typeLabel":"string"},"http_status":{"oneOf":[{"type":"integer","uniqueKey":"http_status.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"http_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"http_status","typeLabel":"integer | null"},"retry_after":{"oneOf":[{"type":"integer","description":"Segundos que conviene esperar antes de reintentar; también llega en el header `Retry-After`.","uniqueKey":"retry_after.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Segundos que conviene esperar antes de reintentar; también llega en el header `Retry-After`.","uniqueKey":"retry_after.oneOf.1","typeLabel":"null"}],"uniqueKey":"retry_after","typeLabel":"integer | null"},"upstream_message":{"oneOf":[{"type":"string","uniqueKey":"upstream_message.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"upstream_message.oneOf.1","typeLabel":"null"}],"uniqueKey":"upstream_message","typeLabel":"string | null"},"source_fault":{"type":"boolean","description":"Si la falla fue de la fuente o de un límite propio de la consulta.","uniqueKey":"source_fault","typeLabel":"boolean"},"failure_cause":{"type":"string","description":"Causa de la falla, en una frase.","uniqueKey":"failure_cause","typeLabel":"string"}},"required":["error","detail","source","reason","retryable"],"uniqueKey":"","typeLabel":"SourceUnavailable · object"},"examples":{"Example":{"title":"Example","value":{"error":"source_unavailable","detail":"\u003cstring>","source":"\u003cstring>","reason":"\u003cstring>","retryable":true,"chain":"\u003cstring>","primitive":"\u003cstring>","operation":"\u003cstring>","target":"\u003cstring>","http_status":123,"retry_after":123,"upstream_message":"\u003cstring>","source_fault":true,"failure_cause":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"bf6449d6-2aef-4fca-b852-835aa59701c1":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Su clave de API en el header `X-API-Key`.","scopes":[],"schemeName":"APIKeyHeader"}},"8564f5c3-9415-44db-857c-97ef375dc31b":{"BearerAuth":{"type":"http","scheme":"bearer","description":"La misma clave de API en `Authorization: Bearer \u003cclave>`, como alternativa a `X-API-Key`.","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"bc197a59-5fb5-45ca-8a5d-a02d2803f4ff":{"url":"https://app.blockgence.com","description":"Producción"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Su clave de API en el header `X-API-Key`.","scopes":[],"schemeName":"APIKeyHeader"},"schema":{"title":"X-API-Key","type":"string","description":"Su clave de API en el header `X-API-Key`.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKeyHeader","name":"X-API-Key"}],"title":"APIKeyHeader"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"La misma clave de API en `Authorization: Bearer \u003cclave>`, como alternativa a `X-API-Key`.","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"La misma clave de API en `Authorization: Bearer \u003cclave>`, como alternativa a `X-API-Key`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.es.json"},"subdomain":"blockgence","siteName":"blockgence","title":"Aportar una etiqueta privada - blockgence","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"es":{"href":"/es/api-reference/post-v1-labels","matchLevel":0},"en":{"href":"/en/api-reference/post-v1-labels","matchLevel":1}}},"lastModified":"2026-11-21T04:04:05.543Z","originalFileLocation":"es/api-reference/post-v1-labels.mdx","locale":"es"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Guarda una etiqueta privada sobre una dirección EVM. Sin X-Case-Id, la etiqueta es de su clave de API (o de su usuario, desde la app); con X-Case-Id, del caso. Solo la ven los pedidos con ese alcance, nunca otros clientes. Cuerpo del pedido. Un objeto Label con address (0x + 40 hex), chain, label, category, source y confidence. Para que una etiqueta aportada no se presente como otra fuente, el servidor fija o limita estos campos: - added_by y method se guardan siempre como \u0026quot;user\u0026quot; y \u0026quot;heuristic\u0026quot;. - source se guarda como \u0026quot;usuario: \u0026quot;, en una línea y con hasta 200 caracteres. - confidence: número entre 0 y 1 (por defecto 0.5), guardado con un máximo de 0.5, por debajo de cualquier otra fuente. - category: bridge, contract, darknet, exchange, mixer, scam, unknown o victim. sanctioned y ex_sanctioned están reservadas: una sanción proviene solo de las listas oficiales. - service_type, conflicting_tags y sanctions_history se guardan vacíos. Respuesta. {\u0026quot;ok\u0026quot;: true, \u0026quot;address\u0026quot;: …, \u0026quot;label\u0026quot;: {…}, \u0026quot;scope\u0026quot;: {…}}, con la etiqueta tal como quedó guardada y el alcance con que se guardó. Errores. 400 si la dirección no es EVM, si la categoría está reservada o no es válida, si confidence está fuera de rango, o si X-Case-Id no corresponde a un caso que usted pueda editar (la etiqueta no se guarda). 422 si un campo no tiene la forma esperada. Costo: 1 crédito.\">\u003cmeta data-mint-head name=\"application-name\" content=\"blockgence\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/blockgence/xl4c32j1Amp8UaZ9/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/blockgence/xl4c32j1Amp8UaZ9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/blockgence/xl4c32j1Amp8UaZ9/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/blockgence/xl4c32j1Amp8UaZ9/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/blockgence/xl4c32j1Amp8UaZ9/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/blockgence/xl4c32j1Amp8UaZ9/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/blockgence/xl4c32j1Amp8UaZ9/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/blockgence/xl4c32j1Amp8UaZ9/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/blockgence/xl4c32j1Amp8UaZ9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Aportar una etiqueta privada - blockgence\">\u003cmeta data-mint-head property=\"og:description\" content=\"Guarda una etiqueta privada sobre una dirección EVM. Sin X-Case-Id, la etiqueta es de su clave de API (o de su usuario, desde la app); con X-Case-Id, del caso. Solo la ven los pedidos con ese alcance, nunca otros clientes. Cuerpo del pedido. Un objeto Label con address (0x + 40 hex), chain, label, category, source y confidence. Para que una etiqueta aportada no se presente como otra fuente, el servidor fija o limita estos campos: - added_by y method se guardan siempre como \u0026quot;user\u0026quot; y \u0026quot;heuristic\u0026quot;. - source se guarda como \u0026quot;usuario: \u0026quot;, en una línea y con hasta 200 caracteres. - confidence: número entre 0 y 1 (por defecto 0.5), guardado con un máximo de 0.5, por debajo de cualquier otra fuente. - category: bridge, contract, darknet, exchange, mixer, scam, unknown o victim. sanctioned y ex_sanctioned están reservadas: una sanción proviene solo de las listas oficiales. - service_type, conflicting_tags y sanctions_history se guardan vacíos. Respuesta. {\u0026quot;ok\u0026quot;: true, \u0026quot;address\u0026quot;: …, \u0026quot;label\u0026quot;: {…}, \u0026quot;scope\u0026quot;: {…}}, con la etiqueta tal como quedó guardada y el alcance con que se guardó. Errores. 400 si la dirección no es EVM, si la categoría está reservada o no es válida, si confidence está fuera de rango, o si X-Case-Id no corresponde a un caso que usted pueda editar (la etiqueta no se guarda). 422 si un campo no tiene la forma esperada. Costo: 1 crédito.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"blockgence\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.blockgence.com/es/api-reference/post-v1-labels\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://blockgence.mintlify.site/_mintlify/api/og/v2?division=Rastreo\u0026amp;title=Aportar+una+etiqueta+privada\u0026amp;description=Guarda+una+etiqueta+privada+sobre+una+direcci%C3%B3n+EVM.+Sin+%60X-Case-Id%60%2C+la+etiqueta+es+de+su+clave+de+API+%28o+de+su%0Ausuario%2C+desde+la+app%29%3B+con+%60X-Case-Id%60%2C+del+ca\u0026amp;theme=e9a290c1d076fc94b92b2551\u0026amp;signature=5bb88b8a2dcf3c3b29f0e94e1df921778eb7d9b92e62eb4c359df5c3e2738682\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Aportar una etiqueta privada - blockgence\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Guarda una etiqueta privada sobre una dirección EVM. Sin X-Case-Id, la etiqueta es de su clave de API (o de su usuario, desde la app); con X-Case-Id, del caso. Solo la ven los pedidos con ese alcance, nunca otros clientes. Cuerpo del pedido. Un objeto Label con address (0x + 40 hex), chain, label, category, source y confidence. Para que una etiqueta aportada no se presente como otra fuente, el servidor fija o limita estos campos: - added_by y method se guardan siempre como \u0026quot;user\u0026quot; y \u0026quot;heuristic\u0026quot;. - source se guarda como \u0026quot;usuario: \u0026quot;, en una línea y con hasta 200 caracteres. - confidence: número entre 0 y 1 (por defecto 0.5), guardado con un máximo de 0.5, por debajo de cualquier otra fuente. - category: bridge, contract, darknet, exchange, mixer, scam, unknown o victim. sanctioned y ex_sanctioned están reservadas: una sanción proviene solo de las listas oficiales. - service_type, conflicting_tags y sanctions_history se guardan vacíos. Respuesta. {\u0026quot;ok\u0026quot;: true, \u0026quot;address\u0026quot;: …, \u0026quot;label\u0026quot;: {…}, \u0026quot;scope\u0026quot;: {…}}, con la etiqueta tal como quedó guardada y el alcance con que se guardó. Errores. 400 si la dirección no es EVM, si la categoría está reservada o no es válida, si confidence está fuera de rango, o si X-Case-Id no corresponde a un caso que usted pueda editar (la etiqueta no se guarda). 422 si un campo no tiene la forma esperada. Costo: 1 crédito.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://blockgence.mintlify.site/_mintlify/api/og/v2?division=Rastreo\u0026amp;title=Aportar+una+etiqueta+privada\u0026amp;description=Guarda+una+etiqueta+privada+sobre+una+direcci%C3%B3n+EVM.+Sin+%60X-Case-Id%60%2C+la+etiqueta+es+de+su+clave+de+API+%28o+de+su%0Ausuario%2C+desde+la+app%29%3B+con+%60X-Case-Id%60%2C+del+ca\u0026amp;theme=e9a290c1d076fc94b92b2551\u0026amp;signature=5bb88b8a2dcf3c3b29f0e94e1df921778eb7d9b92e62eb4c359df5c3e2738682\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/blockgence/xl4c32j1Amp8UaZ9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"blockgence\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2f6fb0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.blockgence.com/es/api-reference/post-v1-labels\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/es/api-reference/post-v1-labels.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.blockgence.com/es/api-reference/post-v1-labels\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.blockgence.com/en/api-reference/post-v1-labels\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.blockgence.com/es/api-reference/post-v1-labels\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.blockgence.com/#organization\",\"name\":\"blockgence\",\"url\":\"https://docs.blockgence.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/blockgence/hQoQZw1-fxGoNXIk/logo/light.svg?fit=max\u0026auto=format\u0026n=hQoQZw1-fxGoNXIk\u0026q=85\u0026s=64dd57006cc9a05bfded0f58fd024838\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.blockgence.com#website\",\"name\":\"blockgence\",\"url\":\"https://docs.blockgence.com\",\"publisher\":{\"@id\":\"https://docs.blockgence.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.blockgence.com/es/api-reference/post-v1-labels#webpage\",\"url\":\"https://docs.blockgence.com/es/api-reference/post-v1-labels\",\"name\":\"Aportar una etiqueta privada\",\"description\":\"Guarda una etiqueta privada sobre una dirección EVM. Sin X-Case-Id, la etiqueta es de su clave de API (o de su usuario, desde la app); con X-Case-Id, del caso. Solo la ven los pedidos con ese alcance, nunca otros clientes. Cuerpo del pedido. Un objeto Label con address (0x + 40 hex), chain, label, category, source y confidence. Para que una etiqueta aportada no se presente como otra fuente, el servidor fija o limita estos campos: - added_by y method se guardan siempre como \\\"user\\\" y \\\"heuristic\\\". - source se guarda como \\\"usuario: \\\", en una línea y con hasta 200 caracteres. - confidence: número entre 0 y 1 (por defecto 0.5), guardado con un máximo de 0.5, por debajo de cualquier otra fuente. - category: bridge, contract, darknet, exchange, mixer, scam, unknown o victim. sanctioned y ex_sanctioned están reservadas: una sanción proviene solo de las listas oficiales. - service_type, conflicting_tags y sanctions_history se guardan vacíos. Respuesta. {\\\"ok\\\": true, \\\"address\\\": …, \\\"label\\\": {…}, \\\"scope\\\": {…}}, con la etiqueta tal como quedó guardada y el alcance con que se guardó. Errores. 400 si la dirección no es EVM, si la categoría está reservada o no es válida, si confidence está fuera de rango, o si X-Case-Id no corresponde a un caso que usted pueda editar (la etiqueta no se guarda). 422 si un campo no tiene la forma esperada. Costo: 1 crédito.\",\"dateModified\":\"2026-11-21T04:04:05.543Z\",\"isPartOf\":{\"@id\":\"https://docs.blockgence.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.blockgence.com/es/api-reference/post-v1-labels#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.blockgence.com/es/api-reference/post-v1-labels#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Referencia\",\"item\":\"https://docs.blockgence.com/es/api/reference\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Rastreo\",\"item\":\"https://docs.blockgence.com/es/api-reference/post-v1-trace\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Aportar una etiqueta privada\",\"item\":\"https://docs.blockgence.com/es/api-reference/post-v1-labels\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.blockgence.com/es/api-reference/post-v1-labels#apireference\",\"headline\":\"Aportar una etiqueta privada\",\"name\":\"Aportar una etiqueta privada\",\"description\":\"Guarda una etiqueta privada sobre una dirección EVM. Sin X-Case-Id, la etiqueta es de su clave de API (o de su usuario, desde la app); con X-Case-Id, del caso. Solo la ven los pedidos con ese alcance, nunca otros clientes. Cuerpo del pedido. Un objeto Label con address (0x + 40 hex), chain, label, category, source y confidence. Para que una etiqueta aportada no se presente como otra fuente, el servidor fija o limita estos campos: - added_by y method se guardan siempre como \\\"user\\\" y \\\"heuristic\\\". - source se guarda como \\\"usuario: \\\", en una línea y con hasta 200 caracteres. - confidence: número entre 0 y 1 (por defecto 0.5), guardado con un máximo de 0.5, por debajo de cualquier otra fuente. - category: bridge, contract, darknet, exchange, mixer, scam, unknown o victim. sanctioned y ex_sanctioned están reservadas: una sanción proviene solo de las listas oficiales. - service_type, conflicting_tags y sanctions_history se guardan vacíos. Respuesta. {\\\"ok\\\": true, \\\"address\\\": …, \\\"label\\\": {…}, \\\"scope\\\": {…}}, con la etiqueta tal como quedó guardada y el alcance con que se guardó. Errores. 400 si la dirección no es EVM, si la categoría está reservada o no es válida, si confidence está fuera de rango, o si X-Case-Id no corresponde a un caso que usted pueda editar (la etiqueta no se guarda). 422 si un campo no tiene la forma esperada. Costo: 1 crédito.\",\"url\":\"https://docs.blockgence.com/es/api-reference/post-v1-labels\",\"mainEntityOfPage\":{\"@id\":\"https://docs.blockgence.com/es/api-reference/post-v1-labels#webpage\"},\"dateModified\":\"2026-11-21T04:04:05.543Z\",\"publisher\":{\"@id\":\"https://docs.blockgence.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.blockgence.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"blockgence\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"blockgence\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/es/api-reference/post-v1-labels.md","siteName":"blockgence","nav":{"global":null,"languages":[{"language":"es","default":true,"tabs":[{"tab":"Empezar","pages":[{"title":"Empezar","href":"/es/get-started/introduction"}]},{"tab":"API","groups":[{"group":"Guías","pages":[{"title":"Autenticación","href":"/es/api/authentication"},{"title":"Errores","href":"/es/api/errors"},{"title":"Paginación y cortes","href":"/es/api/pagination-and-cutoffs"},{"title":"Registro de cambios de la API","href":"/es/api/changelog"}]},{"group":"Referencia","pages":[{"title":"Lectura de la referencia","href":"/es/api/reference"},{"group":"Servicio","pages":[{"title":"Estado del servicio","deprecated":null,"version":null,"sidebarTitle":"Estado del servicio","openapi":"/openapi.es.json get /health","href":"/es/api-reference/get-health"}]},{"group":"Rastreo","pages":[{"title":"Rastrear el flujo de fondos de una dirección","deprecated":null,"version":null,"sidebarTitle":"Rastrear el flujo de fondos de una dirección","openapi":"/openapi.es.json post /v1/trace","href":"/es/api-reference/post-v1-trace"},{"title":"Resumen de riesgo y exposición de un rastreo","deprecated":null,"version":null,"sidebarTitle":"Resumen de riesgo y exposición de un rastreo","openapi":"/openapi.es.json post /v1/report","href":"/es/api-reference/post-v1-report"},{"title":"Paquete de evidencia sellado de un rastreo","deprecated":null,"version":null,"sidebarTitle":"Paquete de evidencia sellado de un rastreo","openapi":"/openapi.es.json post /v1/evidence","href":"/es/api-reference/post-v1-evidence"},{"title":"Informe PDF de un paquete de evidencia","deprecated":null,"version":null,"sidebarTitle":"Informe PDF de un paquete de evidencia","openapi":"/openapi.es.json post /v1/evidence/report.pdf","href":"/es/api-reference/post-v1-evidence-report-pdf"},{"title":"Etiquetas, riesgo y sanciones de una dirección","deprecated":null,"version":null,"sidebarTitle":"Etiquetas, riesgo y sanciones de una dirección","openapi":"/openapi.es.json get /v1/address/{addr}","href":"/es/api-reference/get-v1-address-addr"},{"title":"Ficha on-chain y contrapartes de una dirección","deprecated":null,"version":null,"sidebarTitle":"Ficha on-chain y contrapartes de una dirección","openapi":"/openapi.es.json get /v1/enrich/{addr}","href":"/es/api-reference/get-v1-enrich-addr"},{"title":"Fuente inicial de fondos de una dirección","deprecated":null,"version":null,"sidebarTitle":"Fuente inicial de fondos de una dirección","openapi":"/openapi.es.json get /v1/funding/{addr}","href":"/es/api-reference/get-v1-funding-addr"},{"title":"Redes con actividad de una dirección","deprecated":null,"version":null,"sidebarTitle":"Redes con actividad de una dirección","openapi":"/openapi.es.json get /v1/probe/{addr}","href":"/es/api-reference/get-v1-probe-addr"},{"title":"Mensajes on-chain de una dirección","deprecated":null,"version":null,"sidebarTitle":"Mensajes on-chain de una dirección","openapi":"/openapi.es.json get /v1/messages/{addr}","href":"/es/api-reference/get-v1-messages-addr"},{"title":"Menciones de una dirección en la web abierta","deprecated":null,"version":null,"sidebarTitle":"Menciones de una dirección en la web abierta","openapi":"/openapi.es.json get /v1/osint/{addr}","href":"/es/api-reference/get-v1-osint-addr"},{"title":"Vincular depósitos y retiros de Tornado Cash","deprecated":null,"version":null,"sidebarTitle":"Vincular depósitos y retiros de Tornado Cash","openapi":"/openapi.es.json get /v1/demix/{addr}","href":"/es/api-reference/get-v1-demix-addr"},{"title":"Comparar la huella operativa de varias direcciones (experimental)","deprecated":null,"version":null,"sidebarTitle":"Comparar la huella operativa de varias direcciones (experimental)","openapi":"/openapi.es.json get /v1/fingerprint/{chain}","href":"/es/api-reference/get-v1-fingerprint-chain"},{"title":"Vínculos de contexto de una dirección (experimental)","deprecated":null,"version":null,"sidebarTitle":"Vínculos de contexto de una dirección (experimental)","openapi":"/openapi.es.json get /v1/cluster/{chain}/{addr}","href":"/es/api-reference/get-v1-cluster-chain-addr"},{"title":"Movimientos de una transacción","deprecated":null,"version":null,"sidebarTitle":"Movimientos de una transacción","openapi":"/openapi.es.json get /v1/tx/{txhash}","href":"/es/api-reference/get-v1-tx-txhash"},{"title":"Resolver nombres ENS de varias direcciones","deprecated":null,"version":null,"sidebarTitle":"Resolver nombres ENS de varias direcciones","openapi":"/openapi.es.json post /v1/ens","href":"/es/api-reference/post-v1-ens"},{"title":"Todas las contrapartes de una dirección","deprecated":null,"version":null,"sidebarTitle":"Todas las contrapartes de una dirección","openapi":"/openapi.es.json post /v1/counterparties","href":"/es/api-reference/post-v1-counterparties"},{"title":"Buscar el camino de fondos entre dos direcciones","deprecated":null,"version":null,"sidebarTitle":"Buscar el camino de fondos entre dos direcciones","openapi":"/openapi.es.json post /v1/path","href":"/es/api-reference/post-v1-path"},{"title":"Seguir un cruce por bridge hasta la red destino","deprecated":null,"version":null,"sidebarTitle":"Seguir un cruce por bridge hasta la red destino","openapi":"/openapi.es.json post /v1/stitch","href":"/es/api-reference/post-v1-stitch"},{"title":"Seguir el valor a través de un swap","deprecated":null,"version":null,"sidebarTitle":"Seguir el valor a través de un swap","openapi":"/openapi.es.json post /v1/unswap","href":"/es/api-reference/post-v1-unswap"},{"title":"Etiquetas conocidas de una dirección","description":"Devuelve las etiquetas de una dirección: las públicas (listas de sanciones, registros de entidades y conjunto\nde datos comunitario) y las privadas visibles para el pedido (las de su clave de API y, con `X-Case-Id`, las del\ncaso). Nunca incluye etiquetas aportadas por otros clientes.\n\n**Con `chain`.** Cada etiqueta se muestra como vale en esa red: una etiqueta publicada para otra red trae\n`chain_basis` (por qué se aplica, o no) o viaja como contexto. La dirección se valida como en\n`GET /v1/address/{addr}` (EVM, Tron o Monero).\n\n**Sin `chain`.** Devuelve el listado completo del índice, cada fila con la red para la que se publicó. No es la\nidentidad de la dirección en una red concreta.\n\n**Respuesta.** Una lista de objetos `Label`: `address`, `chain`, `label`, `category`, `source`, `confidence`,\n`method`, `added_by`, `service_type`, `conflicting_tags`, `sanctions_history` y `chain_basis`. Una etiqueta\ncon `added_by: \"user\"` es una que aportó su clave de API.\n\n**Costo:** 1 crédito.","deprecated":null,"version":null,"sidebarTitle":"Etiquetas conocidas de una dirección","openapi":"/openapi.es.json get /v1/labels/{addr}","href":"/es/api-reference/get-v1-labels-addr"},{"title":"Aportar una etiqueta privada","deprecated":null,"version":null,"sidebarTitle":"Aportar una etiqueta privada","openapi":"/openapi.es.json post /v1/labels","href":"/es/api-reference/post-v1-labels"}]},{"group":"Incidentes","pages":[{"title":"Envenenamiento de direcciones","description":"Revisa el historial de una víctima en busca de envenenamiento de direcciones: direcciones parecidas a sus\ncontrapartes legítimas (con los mismos primeros y últimos caracteres) que le enviaron transferencias de valor 0,\nde un token falso o de montos mínimos poco después de una transferencia real, y si la víctima les envió fondos\ndespués.\n\nCada fila de `lookalikes` es una dirección parecida, comparada con la contraparte legítima que mejor la explica\n(`lookalike_of`). Trae `prefix_len`, `suffix_len`, las siembras (`seeds`, con su `kind` y su `timing`), las\npérdidas (`losses`, con su valor en USD a la fecha), `loss_usd`, `reasons` y `status`:\n- `poisoning_with_loss`: patrón de envenenamiento, y la víctima envió fondos a la dirección parecida;\n- `poisoning_attempt`: patrón de envenenamiento, sin pérdida;\n- `lookalike_without_timing`: la dirección se parece, pero ninguna siembra coincide en el tiempo con una\n transferencia legítima. No se afirma envenenamiento.\n\nLa pérdida es un hecho on-chain; que se trate de un envenenamiento es una inferencia. `summary` resume el\nresultado y `coverage.complete: false` indica que el historial leído está incompleto.\n\nSolo redes EVM. Una dirección o una ventana inválidas responden 400, sin cobro. En algunas redes la historia\ncompleta no está disponible: la respuesta es 503, sin cobro, y conviene acotar la ventana con `from_block`. No\ncubre Tron, movimientos nativos internos, direcciones parecidas a quienes enviaron fondos a la víctima ni\nsiembras con NFT (`not_covered`).\n\n**Costo:** 5 créditos de base. Algunas operaciones cobran menos si reutilizan un resultado guardado; nunca más.","deprecated":null,"version":null,"sidebarTitle":"Envenenamiento de direcciones","openapi":"/openapi.es.json get /v1/poisoning/{chain}/{addr}","href":"/es/api-reference/get-v1-poisoning-chain-addr"},{"title":"Víctimas de un drainer","deprecated":null,"version":null,"sidebarTitle":"Víctimas de un drainer","openapi":"/openapi.es.json get /v1/drainer/{chain}/{addr}/victims","href":"/es/api-reference/get-v1-drainer-chain-addr-victims"},{"title":"Víctimas de un estafador","deprecated":null,"version":null,"sidebarTitle":"Víctimas de un estafador","openapi":"/openapi.es.json get /v1/scam/{chain}/{addr}/victims","href":"/es/api-reference/get-v1-scam-chain-addr-victims"},{"title":"Patrimonio de una dirección a una fecha","deprecated":null,"version":null,"sidebarTitle":"Patrimonio de una dirección a una fecha","openapi":"/openapi.es.json get /v1/holdings/{chain}/{addr}","href":"/es/api-reference/get-v1-holdings-chain-addr"},{"title":"Estado de una dirección ante los emisores de stablecoins","deprecated":null,"version":null,"sidebarTitle":"Estado de una dirección ante los emisores de stablecoins","openapi":"/openapi.es.json get /v1/issuer-status/{chain}/{addr}","href":"/es/api-reference/get-v1-issuer-status-chain-addr"},{"title":"Intentos fallidos del atacante","deprecated":null,"version":null,"sidebarTitle":"Intentos fallidos del atacante","openapi":"/openapi.es.json get /v1/attempts/{chain}/{addr}","href":"/es/api-reference/get-v1-attempts-chain-addr"},{"title":"Paquete de congelamiento para la autoridad","deprecated":null,"version":null,"sidebarTitle":"Paquete de congelamiento para la autoridad","openapi":"/openapi.es.json get /v1/freezepack/{case_token}","href":"/es/api-reference/get-v1-freezepack-case-token"},{"title":"Decodificar una transacción","deprecated":null,"version":null,"sidebarTitle":"Decodificar una transacción","openapi":"/openapi.es.json get /v1/decode/{chain}/{hash}","href":"/es/api-reference/get-v1-decode-chain-hash"},{"title":"Devoluciones de un incidente","deprecated":null,"version":null,"sidebarTitle":"Devoluciones de un incidente","openapi":"/openapi.es.json post /v1/returns","href":"/es/api-reference/post-v1-returns"},{"title":"Acuerdo de SEAL Safe Harbor de una dirección","deprecated":null,"version":null,"sidebarTitle":"Acuerdo de SEAL Safe Harbor de una dirección","openapi":"/openapi.es.json get /v1/safe-harbor/{chain}/{addr}","href":"/es/api-reference/get-v1-safe-harbor-chain-addr"},{"title":"Iniciar el playbook de incidente","deprecated":null,"version":null,"sidebarTitle":"Iniciar el playbook de incidente","openapi":"/openapi.es.json post /v1/incident","href":"/es/api-reference/post-v1-incident"},{"title":"Estado de una tarea del playbook de incidente","deprecated":null,"version":null,"sidebarTitle":"Estado de una tarea del playbook de incidente","openapi":"/openapi.es.json get /v1/incident/{job_id}","href":"/es/api-reference/get-v1-incident-job-id"},{"title":"Post-mortem de un incidente","deprecated":null,"version":null,"sidebarTitle":"Post-mortem de un incidente","openapi":"/openapi.es.json get /v1/postmortem/{case_token}","href":"/es/api-reference/get-v1-postmortem-case-token"},{"title":"Entregable de un incidente","deprecated":null,"version":null,"sidebarTitle":"Entregable de un incidente","openapi":"/openapi.es.json get /v1/deliverable/{case_token}","href":"/es/api-reference/get-v1-deliverable-case-token"},{"title":"Triage de una víctima","deprecated":null,"version":null,"sidebarTitle":"Triage de una víctima","openapi":"/openapi.es.json post /v1/triage","href":"/es/api-reference/post-v1-triage"},{"title":"Rastro desde la transacción de pérdida","deprecated":null,"version":null,"sidebarTitle":"Rastro desde la transacción de pérdida","openapi":"/openapi.es.json post /v1/tracetx","href":"/es/api-reference/post-v1-tracetx"},{"title":"Listar los hackeos seguidos","deprecated":null,"version":null,"sidebarTitle":"Listar los hackeos seguidos","openapi":"/openapi.es.json get /v1/tracker","href":"/es/api-reference/get-v1-tracker"},{"title":"Seguir un hackeo","deprecated":null,"version":null,"sidebarTitle":"Seguir un hackeo","openapi":"/openapi.es.json post /v1/tracker","href":"/es/api-reference/post-v1-tracker"},{"title":"Estado de los fondos robados de un hackeo","deprecated":null,"version":null,"sidebarTitle":"Estado de los fondos robados de un hackeo","openapi":"/openapi.es.json get /v1/tracker/{tracker_id}","href":"/es/api-reference/get-v1-tracker-tracker-id"},{"title":"Recalcular el estado de los fondos","deprecated":null,"version":null,"sidebarTitle":"Recalcular el estado de los fondos","openapi":"/openapi.es.json post /v1/tracker/{tracker_id}/recompute","href":"/es/api-reference/post-v1-tracker-tracker-id-recompute"},{"title":"Vectores de ataque más frecuentes","deprecated":null,"version":null,"sidebarTitle":"Vectores de ataque más frecuentes","openapi":"/openapi.es.json get /v1/attack-vectors","href":"/es/api-reference/get-v1-attack-vectors"},{"title":"Pulso semanal del lavado","deprecated":null,"version":null,"sidebarTitle":"Pulso semanal del lavado","openapi":"/openapi.es.json get /v1/laundering-pulse","href":"/es/api-reference/get-v1-laundering-pulse"}]},{"group":"Casos","pages":[{"title":"Listar casos","deprecated":null,"version":null,"sidebarTitle":"Listar casos","openapi":"/openapi.es.json get /v1/cases","href":"/es/api-reference/get-v1-cases"},{"title":"Crear un caso","deprecated":null,"version":null,"sidebarTitle":"Crear un caso","openapi":"/openapi.es.json post /v1/cases","href":"/es/api-reference/post-v1-cases"},{"title":"Importar un expediente","deprecated":null,"version":null,"sidebarTitle":"Importar un expediente","openapi":"/openapi.es.json post /v1/cases/import","href":"/es/api-reference/post-v1-cases-import"},{"title":"Listar invitaciones de otras organizaciones","deprecated":null,"version":null,"sidebarTitle":"Listar invitaciones de otras organizaciones","openapi":"/openapi.es.json get /v1/cases/invitations","href":"/es/api-reference/get-v1-cases-invitations"},{"title":"Aceptar una invitación de otra organización","deprecated":null,"version":null,"sidebarTitle":"Aceptar una invitación de otra organización","openapi":"/openapi.es.json post /v1/cases/invitations/{share_id}/accept","href":"/es/api-reference/post-v1-cases-invitations-share-id-accept"},{"title":"Rechazar una invitación de otra organización","deprecated":null,"version":null,"sidebarTitle":"Rechazar una invitación de otra organización","openapi":"/openapi.es.json post /v1/cases/invitations/{share_id}/decline","href":"/es/api-reference/post-v1-cases-invitations-share-id-decline"},{"title":"Obtener un caso","deprecated":null,"version":null,"sidebarTitle":"Obtener un caso","openapi":"/openapi.es.json get /v1/cases/{token}","href":"/es/api-reference/get-v1-cases-token"},{"title":"Guardar un caso","deprecated":null,"version":null,"sidebarTitle":"Guardar un caso","openapi":"/openapi.es.json put /v1/cases/{token}","href":"/es/api-reference/put-v1-cases-token"},{"title":"Eliminar un caso","deprecated":null,"version":null,"sidebarTitle":"Eliminar un caso","openapi":"/openapi.es.json delete /v1/cases/{token}","href":"/es/api-reference/delete-v1-cases-token"},{"title":"Cadena de custodia del caso","deprecated":null,"version":null,"sidebarTitle":"Cadena de custodia del caso","openapi":"/openapi.es.json get /v1/cases/{token}/activity","href":"/es/api-reference/get-v1-cases-token-activity"},{"title":"Listar con quién se comparte un caso","deprecated":null,"version":null,"sidebarTitle":"Listar con quién se comparte un caso","openapi":"/openapi.es.json get /v1/cases/{token}/shares","href":"/es/api-reference/get-v1-cases-token-shares"},{"title":"Compartir un caso en la organización","deprecated":null,"version":null,"sidebarTitle":"Compartir un caso en la organización","openapi":"/openapi.es.json post /v1/cases/{token}/shares","href":"/es/api-reference/post-v1-cases-token-shares"},{"title":"Compartir un caso con otra organización","deprecated":null,"version":null,"sidebarTitle":"Compartir un caso con otra organización","openapi":"/openapi.es.json post /v1/cases/{token}/external-shares","href":"/es/api-reference/post-v1-cases-token-external-shares"},{"title":"Revocar el acceso de otra organización","deprecated":null,"version":null,"sidebarTitle":"Revocar el acceso de otra organización","openapi":"/openapi.es.json delete /v1/cases/{token}/external-shares/{share_id}","href":"/es/api-reference/delete-v1-cases-token-external-shares-share-id"},{"title":"Dejar de ver un caso de otra organización","deprecated":null,"version":null,"sidebarTitle":"Dejar de ver un caso de otra organización","openapi":"/openapi.es.json delete /v1/cases/{token}/external-access","href":"/es/api-reference/delete-v1-cases-token-external-access"},{"title":"Dejar de compartir un caso","deprecated":null,"version":null,"sidebarTitle":"Dejar de compartir un caso","openapi":"/openapi.es.json delete /v1/cases/{token}/shares/{share_id}","href":"/es/api-reference/delete-v1-cases-token-shares-share-id"},{"title":"Listar las anotaciones de un caso","deprecated":null,"version":null,"sidebarTitle":"Listar las anotaciones de un caso","openapi":"/openapi.es.json get /v1/cases/{token}/annotations","href":"/es/api-reference/get-v1-cases-token-annotations"},{"title":"Agregar una anotación a un caso","deprecated":null,"version":null,"sidebarTitle":"Agregar una anotación a un caso","openapi":"/openapi.es.json post /v1/cases/{token}/annotations","href":"/es/api-reference/post-v1-cases-token-annotations"},{"title":"Quitar una anotación de un caso","deprecated":null,"version":null,"sidebarTitle":"Quitar una anotación de un caso","openapi":"/openapi.es.json delete /v1/cases/{token}/annotations/{annotation_id}","href":"/es/api-reference/delete-v1-cases-token-annotations-annotation-id"},{"title":"Cruces con otros casos","deprecated":null,"version":null,"sidebarTitle":"Cruces con otros casos","openapi":"/openapi.es.json get /v1/cases/{token}/overlaps","href":"/es/api-reference/get-v1-cases-token-overlaps"},{"title":"Registro de cambios del caso","deprecated":null,"version":null,"sidebarTitle":"Registro de cambios del caso","openapi":"/openapi.es.json get /v1/cases/{token}/changes","href":"/es/api-reference/get-v1-cases-token-changes"},{"title":"Paquete de evidencia del caso","deprecated":null,"version":null,"sidebarTitle":"Paquete de evidencia del caso","openapi":"/openapi.es.json get /v1/cases/{token}/evidence","href":"/es/api-reference/get-v1-cases-token-evidence"},{"title":"Paquete de evidencia e informe PDF en un ZIP","deprecated":null,"version":null,"sidebarTitle":"Paquete de evidencia e informe PDF en un ZIP","openapi":"/openapi.es.json get /v1/cases/{token}/evidence.zip","href":"/es/api-reference/get-v1-cases-token-evidence-zip"},{"title":"Off-ramps del caso","deprecated":null,"version":null,"sidebarTitle":"Off-ramps del caso","openapi":"/openapi.es.json get /v1/cases/{token}/offramps","href":"/es/api-reference/get-v1-cases-token-offramps"},{"title":"Off-ramps del caso en CSV","deprecated":null,"version":null,"sidebarTitle":"Off-ramps del caso en CSV","openapi":"/openapi.es.json get /v1/cases/{token}/offramps.csv","href":"/es/api-reference/get-v1-cases-token-offramps-csv"},{"title":"Borrador de reporte de operación sospechosa","deprecated":null,"version":null,"sidebarTitle":"Borrador de reporte de operación sospechosa","openapi":"/openapi.es.json get /v1/cases/{token}/report/{kind}","href":"/es/api-reference/get-v1-cases-token-report-kind"},{"title":"Exportar el expediente de un caso","deprecated":null,"version":null,"sidebarTitle":"Exportar el expediente de un caso","openapi":"/openapi.es.json get /v1/cases/{token}/export","href":"/es/api-reference/get-v1-cases-token-export"},{"title":"Ficha IVMS 101 de transacciones del caso","deprecated":null,"version":null,"sidebarTitle":"Ficha IVMS 101 de transacciones del caso","openapi":"/openapi.es.json get /v1/cases/{token}/ivms101","href":"/es/api-reference/get-v1-cases-token-ivms101"}]},{"group":"Travel Rule","pages":[{"title":"Desafío de titularidad","deprecated":null,"version":null,"sidebarTitle":"Desafío de titularidad","openapi":"/openapi.es.json post /v1/travel-rule/challenge","href":"/es/api-reference/post-v1-travel-rule-challenge"},{"title":"Contraparte de una dirección","deprecated":null,"version":null,"sidebarTitle":"Contraparte de una dirección","openapi":"/openapi.es.json post /v1/travel-rule/counterparty","href":"/es/api-reference/post-v1-travel-rule-counterparty"},{"title":"Conciliar un mensaje de Travel Rule","deprecated":null,"version":null,"sidebarTitle":"Conciliar un mensaje de Travel Rule","openapi":"/openapi.es.json post /v1/travel-rule/reconcile","href":"/es/api-reference/post-v1-travel-rule-reconcile"},{"title":"Validar un mensaje IVMS101","deprecated":null,"version":null,"sidebarTitle":"Validar un mensaje IVMS101","openapi":"/openapi.es.json post /v1/travel-rule/ivms101/validate","href":"/es/api-reference/post-v1-travel-rule-ivms101-validate"}]},{"group":"Monero","pages":[{"title":"Ficha de una transacción de Monero","deprecated":null,"version":null,"sidebarTitle":"Ficha de una transacción de Monero","openapi":"/openapi.es.json get /v1/monero/tx/{txid}","href":"/es/api-reference/get-v1-monero-tx-txid"},{"title":"Verificar un pago en Monero","deprecated":null,"version":null,"sidebarTitle":"Verificar un pago en Monero","openapi":"/openapi.es.json post /v1/monero/proof","href":"/es/api-reference/post-v1-monero-proof"}]},{"group":"Plataforma","pages":[{"title":"Redes y capacidades","deprecated":null,"version":null,"sidebarTitle":"Redes y capacidades","openapi":"/openapi.es.json get /v1/chains","href":"/es/api-reference/get-v1-chains"},{"title":"Una red y sus capacidades","deprecated":null,"version":null,"sidebarTitle":"Una red y sus capacidades","openapi":"/openapi.es.json get /v1/chains/{chain}","href":"/es/api-reference/get-v1-chains-chain"},{"title":"Fuentes de datos y su estado","deprecated":null,"version":null,"sidebarTitle":"Fuentes de datos y su estado","openapi":"/openapi.es.json get /v1/sources","href":"/es/api-reference/get-v1-sources"},{"title":"Listas de sanciones","deprecated":null,"version":null,"sidebarTitle":"Listas de sanciones","openapi":"/openapi.es.json get /v1/sanctions/lists","href":"/es/api-reference/get-v1-sanctions-lists"},{"title":"Metodología publicada","deprecated":null,"version":null,"sidebarTitle":"Metodología publicada","openapi":"/openapi.es.json get /v1/methodology","href":"/es/api-reference/get-v1-methodology"},{"title":"Una entrada de la metodología","deprecated":null,"version":null,"sidebarTitle":"Una entrada de la metodología","openapi":"/openapi.es.json get /v1/methodology/{entry_id}","href":"/es/api-reference/get-v1-methodology-entry-id"}]},{"group":"Permisos","pages":[{"title":"Permisos otorgados por una dirección","deprecated":null,"version":null,"sidebarTitle":"Permisos otorgados por una dirección","openapi":"/openapi.es.json get /v1/approvals/{chain}/{addr}","href":"/es/api-reference/get-v1-approvals-chain-addr"},{"title":"Permisos otorgados a un spender","deprecated":null,"version":null,"sidebarTitle":"Permisos otorgados a un spender","openapi":"/openapi.es.json get /v1/approvals-by-spender/{chain}/{spender}","href":"/es/api-reference/get-v1-approvals-by-spender-chain-spender"},{"title":"Salidas en transacciones de terceros","deprecated":null,"version":null,"sidebarTitle":"Salidas en transacciones de terceros","openapi":"/openapi.es.json get /v1/signature-drains/{chain}/{addr}","href":"/es/api-reference/get-v1-signature-drains-chain-addr"},{"title":"Salidas en transacciones de terceros, vista rápida","deprecated":null,"version":null,"sidebarTitle":"Salidas en transacciones de terceros, vista rápida","openapi":"/openapi.es.json get /v1/third-party-outflows/{chain}/{addr}","href":"/es/api-reference/get-v1-third-party-outflows-chain-addr"},{"title":"Delegaciones EIP-7702","deprecated":null,"version":null,"sidebarTitle":"Delegaciones EIP-7702","openapi":"/openapi.es.json get /v1/delegation/{addr}","href":"/es/api-reference/get-v1-delegation-addr"}]},{"group":"Compromiso","pages":[{"title":"Vector de compromiso","deprecated":null,"version":null,"sidebarTitle":"Vector de compromiso","openapi":"/openapi.es.json post /v1/compromise","href":"/es/api-reference/post-v1-compromise"}]},{"group":"Contratos","pages":[{"title":"Inspección de un contrato","deprecated":null,"version":null,"sidebarTitle":"Inspección de un contrato","openapi":"/openapi.es.json get /v1/contract/{chain}/{addr}","href":"/es/api-reference/get-v1-contract-chain-addr"},{"title":"Simular una transacción","deprecated":null,"version":null,"sidebarTitle":"Simular una transacción","openapi":"/openapi.es.json post /v1/simulate","href":"/es/api-reference/post-v1-simulate"}]},{"group":"Guard","pages":[{"title":"Estado de Guard","deprecated":null,"version":null,"sidebarTitle":"Estado de Guard","openapi":"/openapi.es.json get /v1/guard/status","href":"/es/api-reference/get-v1-guard-status"},{"title":"Listar vigilancias","deprecated":null,"version":null,"sidebarTitle":"Listar vigilancias","openapi":"/openapi.es.json get /v1/guard/watches","href":"/es/api-reference/get-v1-guard-watches"},{"title":"Crear una vigilancia","deprecated":null,"version":null,"sidebarTitle":"Crear una vigilancia","openapi":"/openapi.es.json post /v1/guard/watches","href":"/es/api-reference/post-v1-guard-watches"},{"title":"Obtener una vigilancia","deprecated":null,"version":null,"sidebarTitle":"Obtener una vigilancia","openapi":"/openapi.es.json get /v1/guard/watches/{wid}","href":"/es/api-reference/get-v1-guard-watches-wid"},{"title":"Eliminar una vigilancia","deprecated":null,"version":null,"sidebarTitle":"Eliminar una vigilancia","openapi":"/openapi.es.json delete /v1/guard/watches/{wid}","href":"/es/api-reference/delete-v1-guard-watches-wid"},{"title":"Modificar una vigilancia","deprecated":null,"version":null,"sidebarTitle":"Modificar una vigilancia","openapi":"/openapi.es.json patch /v1/guard/watches/{wid}","href":"/es/api-reference/patch-v1-guard-watches-wid"},{"title":"Listar la actividad de una vigilancia","deprecated":null,"version":null,"sidebarTitle":"Listar la actividad de una vigilancia","openapi":"/openapi.es.json get /v1/guard/watches/{wid}/events","href":"/es/api-reference/get-v1-guard-watches-wid-events"},{"title":"Árbol de vigilancias derivadas","deprecated":null,"version":null,"sidebarTitle":"Árbol de vigilancias derivadas","openapi":"/openapi.es.json get /v1/guard/watches/{wid}/hops","href":"/es/api-reference/get-v1-guard-watches-wid-hops"},{"title":"Listar alertas","deprecated":null,"version":null,"sidebarTitle":"Listar alertas","openapi":"/openapi.es.json get /v1/guard/alerts","href":"/es/api-reference/get-v1-guard-alerts"},{"title":"Obtener una alerta","deprecated":null,"version":null,"sidebarTitle":"Obtener una alerta","openapi":"/openapi.es.json get /v1/guard/alerts/{aid}","href":"/es/api-reference/get-v1-guard-alerts-aid"},{"title":"Operar una alerta","deprecated":null,"version":null,"sidebarTitle":"Operar una alerta","openapi":"/openapi.es.json patch /v1/guard/alerts/{aid}","href":"/es/api-reference/patch-v1-guard-alerts-aid"},{"title":"Abrir un caso desde una alerta","deprecated":null,"version":null,"sidebarTitle":"Abrir un caso desde una alerta","openapi":"/openapi.es.json post /v1/guard/alerts/{aid}/case","href":"/es/api-reference/post-v1-guard-alerts-aid-case"},{"title":"Listar protocolos","deprecated":null,"version":null,"sidebarTitle":"Listar protocolos","openapi":"/openapi.es.json get /v1/guard/protocols","href":"/es/api-reference/get-v1-guard-protocols"},{"title":"Registrar un protocolo","deprecated":null,"version":null,"sidebarTitle":"Registrar un protocolo","openapi":"/openapi.es.json post /v1/guard/protocols","href":"/es/api-reference/post-v1-guard-protocols"},{"title":"Obtener un protocolo","deprecated":null,"version":null,"sidebarTitle":"Obtener un protocolo","openapi":"/openapi.es.json get /v1/guard/protocols/{pid}","href":"/es/api-reference/get-v1-guard-protocols-pid"},{"title":"Eliminar un protocolo","deprecated":null,"version":null,"sidebarTitle":"Eliminar un protocolo","openapi":"/openapi.es.json delete /v1/guard/protocols/{pid}","href":"/es/api-reference/delete-v1-guard-protocols-pid"},{"title":"Modificar un protocolo","deprecated":null,"version":null,"sidebarTitle":"Modificar un protocolo","openapi":"/openapi.es.json patch /v1/guard/protocols/{pid}","href":"/es/api-reference/patch-v1-guard-protocols-pid"},{"title":"Eventos del ABI verificado de un contrato","deprecated":null,"version":null,"sidebarTitle":"Eventos del ABI verificado de un contrato","openapi":"/openapi.es.json get /v1/guard/protocols/{pid}/abi-events","href":"/es/api-reference/get-v1-guard-protocols-pid-abi-events"},{"title":"Listar personas asignables","deprecated":null,"version":null,"sidebarTitle":"Listar personas asignables","openapi":"/openapi.es.json get /v1/guard/members","href":"/es/api-reference/get-v1-guard-members"},{"title":"Configuración de avisos","deprecated":null,"version":null,"sidebarTitle":"Configuración de avisos","openapi":"/openapi.es.json get /v1/guard/notifications","href":"/es/api-reference/get-v1-guard-notifications"},{"title":"Crear un webhook","deprecated":null,"version":null,"sidebarTitle":"Crear un webhook","openapi":"/openapi.es.json post /v1/guard/webhooks","href":"/es/api-reference/post-v1-guard-webhooks"},{"title":"Eliminar un webhook","deprecated":null,"version":null,"sidebarTitle":"Eliminar un webhook","openapi":"/openapi.es.json delete /v1/guard/webhooks/{hid}","href":"/es/api-reference/delete-v1-guard-webhooks-hid"},{"title":"Modificar un webhook","deprecated":null,"version":null,"sidebarTitle":"Modificar un webhook","openapi":"/openapi.es.json patch /v1/guard/webhooks/{hid}","href":"/es/api-reference/patch-v1-guard-webhooks-hid"},{"title":"Enviar un mensaje de prueba","deprecated":null,"version":null,"sidebarTitle":"Enviar un mensaje de prueba","openapi":"/openapi.es.json post /v1/guard/webhooks/{hid}/test","href":"/es/api-reference/post-v1-guard-webhooks-hid-test"},{"title":"Listar entregas de un webhook","deprecated":null,"version":null,"sidebarTitle":"Listar entregas de un webhook","openapi":"/openapi.es.json get /v1/guard/webhooks/{hid}/deliveries","href":"/es/api-reference/get-v1-guard-webhooks-hid-deliveries"},{"title":"Configurar el resumen por correo","deprecated":null,"version":null,"sidebarTitle":"Configurar el resumen por correo","openapi":"/openapi.es.json put /v1/guard/email","href":"/es/api-reference/put-v1-guard-email"}]},{"group":"Tokens","pages":[{"title":"Ficha de un token","deprecated":null,"version":null,"sidebarTitle":"Ficha de un token","openapi":"/openapi.es.json get /v1/token/{chain}/{addr}","href":"/es/api-reference/get-v1-token-chain-addr"}]},{"group":"Auditoría","pages":[{"title":"Listar las auditorías de la organización","deprecated":null,"version":null,"sidebarTitle":"Listar las auditorías de la organización","openapi":"/openapi.es.json get /v1/audit","href":"/es/api-reference/get-v1-audit"},{"title":"Pedir una revisión de smart contracts","deprecated":null,"version":null,"sidebarTitle":"Pedir una revisión de smart contracts","openapi":"/openapi.es.json post /v1/audit","href":"/es/api-reference/post-v1-audit"},{"title":"Resumen de una auditoría","deprecated":null,"version":null,"sidebarTitle":"Resumen de una auditoría","openapi":"/openapi.es.json get /v1/audit/{audit_id}","href":"/es/api-reference/get-v1-audit-audit-id"},{"title":"Consultar al copiloto de una auditoría","deprecated":null,"version":null,"sidebarTitle":"Consultar al copiloto de una auditoría","openapi":"/openapi.es.json post /v1/audit/{audit_id}/copilot","href":"/es/api-reference/post-v1-audit-audit-id-copilot"},{"title":"Solicitudes registradas por el copiloto","deprecated":null,"version":null,"sidebarTitle":"Solicitudes registradas por el copiloto","openapi":"/openapi.es.json get /v1/audit/{audit_id}/requests","href":"/es/api-reference/get-v1-audit-audit-id-requests"},{"title":"Una sección de una auditoría","deprecated":null,"version":null,"sidebarTitle":"Una sección de una auditoría","openapi":"/openapi.es.json get /v1/audit/{audit_id}/{section}","href":"/es/api-reference/get-v1-audit-audit-id-section"},{"title":"Cargar las direcciones desplegadas de una revisión","deprecated":null,"version":null,"sidebarTitle":"Cargar las direcciones desplegadas de una revisión","openapi":"/openapi.es.json post /v1/audit/{audit_id}/deploy","href":"/es/api-reference/post-v1-audit-audit-id-deploy"},{"title":"Agregar una nota del equipo","deprecated":null,"version":null,"sidebarTitle":"Agregar una nota del equipo","openapi":"/openapi.es.json post /v1/audit/{audit_id}/notes","href":"/es/api-reference/post-v1-audit-audit-id-notes"},{"title":"Quitar una nota del equipo","deprecated":null,"version":null,"sidebarTitle":"Quitar una nota del equipo","openapi":"/openapi.es.json delete /v1/audit/{audit_id}/notes/{note_id}","href":"/es/api-reference/delete-v1-audit-audit-id-notes-note-id"}]},{"group":"Copiloto","pages":[{"title":"Copiloto de investigación","deprecated":null,"version":null,"sidebarTitle":"Copiloto de investigación","openapi":"/openapi.es.json post /v1/copilot","href":"/es/api-reference/post-v1-copilot"}]},{"group":"Screening","pages":[{"title":"Screening de una dirección","deprecated":null,"version":null,"sidebarTitle":"Screening de una dirección","openapi":"/openapi.es.json get /v1/screening/{addr}","href":"/es/api-reference/get-v1-screening-addr"},{"title":"Seguridad de un contrato o una dirección","deprecated":null,"version":null,"sidebarTitle":"Seguridad de un contrato o una dirección","openapi":"/openapi.es.json get /v1/security/{addr}","href":"/es/api-reference/get-v1-security-addr"}]},{"group":"Cuenta","pages":[{"title":"Consumo y límites","deprecated":null,"version":null,"sidebarTitle":"Consumo y límites","openapi":"/openapi.es.json get /v1/account","href":"/es/api-reference/get-v1-account"}]},{"group":"Íconos","pages":[{"title":"Logo de una entidad por nombre","deprecated":null,"version":null,"sidebarTitle":"Logo de una entidad por nombre","openapi":"/openapi.es.json get /v1/icon/named/{slug}.png","href":"/es/api-reference/get-v1-icon-named-slug-png"},{"title":"Logo de un token o contrato","deprecated":null,"version":null,"sidebarTitle":"Logo de un token o contrato","openapi":"/openapi.es.json get /v1/icon/{chain}/{address}.png","href":"/es/api-reference/get-v1-icon-chain-address-png"}]},{"group":"Evidencia","pages":[{"title":"Clave pública de firma","deprecated":null,"version":null,"sidebarTitle":"Clave pública de firma","openapi":"/openapi.es.json get /v1/evidence/signing-key","href":"/es/api-reference/get-v1-evidence-signing-key"},{"title":"Sello de tiempo de un documento","deprecated":null,"version":null,"sidebarTitle":"Sello de tiempo de un documento","openapi":"/openapi.es.json get /v1/evidence/timestamp/{name}","href":"/es/api-reference/get-v1-evidence-timestamp-name"}]}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/es/mcp/connect"}]},{"tab":"Productos","pages":[{"title":"Productos","href":"/es/products/investigation"}]},{"tab":"Metodología y evidencia","pages":[{"title":"Metodología y evidencia","href":"/es/methodology/sealing"}]}]},{"language":"en","pages":[{"title":"en","href":"/en/api-reference/post-v1-labels"}]}]},"basePath":"","title":"Aportar una etiqueta privada - blockgence","deploymentId":"dpl_7LpC8LvxVNTZSB7twCcVwH4TeFKv","buildId":"dpl_7LpC8LvxVNTZSB7twCcVwH4TeFKv","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-VIWbtsv8.js","snippetPresets-ewmdA2iz.js","utils-DEEnXwTM.js","style-to-object-BY3JEAdk.js","utils-BUI5OFKw.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DczDVjtE.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C1QFmpNs.js","_Uint8Array-0FSGLZoF.js","isObject-FP1Yky1u.js","ApiExamples-DNfazWM6.js","usePlaygroundInputsStore-CU9Zyvn9.js","shallow-DBWJPCN_.js","isEqual-BgubGfZd.js","CodeSnippets-WO5yBq5U.js","CodeSnippet-CATPUnsR.js","getApiPlaygroundDisplay-DVuSDqoz.js","Page-B2HLrc-g.js","DynamicMarkdown-D4bAuXRS.js","SectionHeading-BNNqN1He.js","icon-C7peNQV4.js","MethodPill-Bl2guf_0.js","getPastedJson-B_gFzCQb.js","Check2Icon-BLniSudB.js","axios-CsQoIw0U.js","Markdown-sagBpmAe.js","AssistantPageLink-CgMPWeT2.js","dist-C5tMjMKm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}