Saves a private label for an EVM address. Without X-Case-Id, the label belongs to your API key (or to your
user, from the app); with X-Case-Id, to the case. Only requests with that scope see it, never other
customers.
Request body. A Label object with address (0x + 40 hex), chain, label, category, source and
confidence. So that a contributed label cannot pose as another source, the server sets or limits these
fields:
added_by and method are always saved as "user" and "heuristic".
source is saved as "usuario: <text>", on one line and with up to 200 characters.
confidence: a number between 0 and 1 (default 0.5), saved with a maximum of 0.5, below any other source.
category: bridge, contract, darknet, exchange, mixer, scam, unknown or victim.
sanctioned and ex_sanctioned are reserved: a sanction comes only from the official lists.
service_type, conflicting_tags and sanctions_history are saved empty.
Response.{"ok": true, "address": …, "label": {…}, "scope": {…}}, with the label as saved and the scope
it was saved with.
Errors.400 if the address is not EVM, if the category is reserved or invalid, if confidence is out of
range, or if X-Case-Id does not match a case you can edit (the label is not saved). 422 if a field does not
have the expected shape.
Optional case the label is added to: the token of a case you can edit. Without this header, the label belongs to your API key. A case that does not exist or that you cannot edit returns 400 and the label is not saved.
Body
application/json
address
string
required
label
string
required
chain
string
default:ethereum
category
string
default:unknown
source
string
default:""
confidence
number
default:0.5
method
string
default:heuristic
added_by
string
default:seed
service_type
enum<string> | null
Available options:
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
Available options:
source_row,
source_snapshot,
source_commit,
measured,
analyst,
none
valid_until
string | null
validity
enum<string> | null
Available options:
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
Response
Successful response.
{"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":"en/api-reference/post-v1-labels","slug":"/en/api-reference/post-v1-labels","pageMetadata":{"title":"Contribute a private label","description":"Saves a private label for an EVM address. Without `X-Case-Id`, the label belongs to your API key (or to your\nuser, from the app); with `X-Case-Id`, to the case. Only requests with that scope see it, never other\ncustomers.\n\n**Request body.** A `Label` object with `address` (`0x` + 40 hex), `chain`, `label`, `category`, `source` and\n`confidence`. So that a contributed label cannot pose as another source, the server sets or limits these\nfields:\n- `added_by` and `method` are always saved as `\"user\"` and `\"heuristic\"`.\n- `source` is saved as `\"usuario: \u003ctext>\"`, on one line and with up to 200 characters.\n- `confidence`: a number between 0 and 1 (default 0.5), saved with a maximum of 0.5, below any other source.\n- `category`: `bridge`, `contract`, `darknet`, `exchange`, `mixer`, `scam`, `unknown` or `victim`.\n `sanctioned` and `ex_sanctioned` are reserved: a sanction comes only from the official lists.\n- `service_type`, `conflicting_tags` and `sanctions_history` are saved empty.\n\n**Response.** `{\"ok\": true, \"address\": …, \"label\": {…}, \"scope\": {…}}`, with the label as saved and the scope\nit was saved with.\n\n**Errors.** `400` if the address is not EVM, if the category is reserved or invalid, if `confidence` is out of\nrange, or if `X-Case-Id` does not match a case you can edit (the label is not saved). `422` if a field does not\nhave the expected shape.\n\n**Cost:** 1 credit.","deprecated":null,"version":null,"sidebarTitle":"Contribute a private label","openapi":"/openapi.en.json post /v1/labels","href":"/en/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: [\"Saves a private label for an EVM address. Without \", _jsx(_components.code, {\n children: \"X-Case-Id\"\n }), \", the label belongs to your API key (or to your\\nuser, from the app); with \", _jsx(_components.code, {\n children: \"X-Case-Id\"\n }), \", to the case. Only requests with that scope see it, never other\\ncustomers.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Request body.\"\n }), \" A \", _jsx(_components.code, {\n children: \"Label\"\n }), \" object with \", _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 }), \" and\\n\", _jsx(_components.code, {\n children: \"confidence\"\n }), \". So that a contributed label cannot pose as another source, the server sets or limits these\\nfields:\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"added_by\"\n }), \" and \", _jsx(_components.code, {\n children: \"method\"\n }), \" are always saved as \", _jsx(_components.code, {\n children: \"\\\"user\\\"\"\n }), \" and \", _jsx(_components.code, {\n children: \"\\\"heuristic\\\"\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"source\"\n }), \" is saved as \", _jsx(_components.code, {\n children: \"\\\"usuario: \u003ctext>\\\"\"\n }), \", on one line and with up to 200 characters.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"confidence\"\n }), \": a number between 0 and 1 (default 0.5), saved with a maximum of 0.5, below any other source.\"]\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 }), \" or \", _jsx(_components.code, {\n children: \"victim\"\n }), \".\\n\", _jsx(_components.code, {\n children: \"sanctioned\"\n }), \" and \", _jsx(_components.code, {\n children: \"ex_sanctioned\"\n }), \" are reserved: a sanction comes only from the official lists.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"service_type\"\n }), \", \", _jsx(_components.code, {\n children: \"conflicting_tags\"\n }), \" and \", _jsx(_components.code, {\n children: \"sanctions_history\"\n }), \" are saved empty.\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Response.\"\n }), \" \", _jsx(_components.code, {\n children: \"{\\\"ok\\\": true, \\\"address\\\": …, \\\"label\\\": {…}, \\\"scope\\\": {…}}\"\n }), \", with the label as saved and the scope\\nit was saved with.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Errors.\"\n }), \" \", _jsx(_components.code, {\n children: \"400\"\n }), \" if the address is not EVM, if the category is reserved or invalid, if \", _jsx(_components.code, {\n children: \"confidence\"\n }), \" is out of\\nrange, or if \", _jsx(_components.code, {\n children: \"X-Case-Id\"\n }), \" does not match a case you can edit (the label is not saved). \", _jsx(_components.code, {\n children: \"422\"\n }), \" if a field does not\\nhave the expected shape.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Cost:\"\n }), \" 1 credit.\"]\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":"Contribute a private label","description":"Saves a private label for an EVM address. Without `X-Case-Id`, the label belongs to your API key (or to your\nuser, from the app); with `X-Case-Id`, to the case. Only requests with that scope see it, never other\ncustomers.\n\n**Request body.** A `Label` object with `address` (`0x` + 40 hex), `chain`, `label`, `category`, `source` and\n`confidence`. So that a contributed label cannot pose as another source, the server sets or limits these\nfields:\n- `added_by` and `method` are always saved as `\"user\"` and `\"heuristic\"`.\n- `source` is saved as `\"usuario: \u003ctext>\"`, on one line and with up to 200 characters.\n- `confidence`: a number between 0 and 1 (default 0.5), saved with a maximum of 0.5, below any other source.\n- `category`: `bridge`, `contract`, `darknet`, `exchange`, `mixer`, `scam`, `unknown` or `victim`.\n `sanctioned` and `ex_sanctioned` are reserved: a sanction comes only from the official lists.\n- `service_type`, `conflicting_tags` and `sanctions_history` are saved empty.\n\n**Response.** `{\"ok\": true, \"address\": …, \"label\": {…}, \"scope\": {…}}`, with the label as saved and the scope\nit was saved with.\n\n**Errors.** `400` if the address is not EVM, if the category is reserved or invalid, if `confidence` is out of\nrange, or if `X-Case-Id` does not match a case you can edit (the label is not saved). `422` if a field does not\nhave the expected shape.\n\n**Cost:** 1 credit.","deprecated":null,"version":null,"sidebarTitle":"Contribute a private label","openapi":"/openapi.en.json post /v1/labels","href":"/en/api-reference/post-v1-labels","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Tracing"],"summary":"Contribute a private label","description":"Saves a private label for an EVM address. Without `X-Case-Id`, the label belongs to your API key (or to your\nuser, from the app); with `X-Case-Id`, to the case. Only requests with that scope see it, never other\ncustomers.\n\n**Request body.** A `Label` object with `address` (`0x` + 40 hex), `chain`, `label`, `category`, `source` and\n`confidence`. So that a contributed label cannot pose as another source, the server sets or limits these\nfields:\n- `added_by` and `method` are always saved as `\"user\"` and `\"heuristic\"`.\n- `source` is saved as `\"usuario: \u003ctext>\"`, on one line and with up to 200 characters.\n- `confidence`: a number between 0 and 1 (default 0.5), saved with a maximum of 0.5, below any other source.\n- `category`: `bridge`, `contract`, `darknet`, `exchange`, `mixer`, `scam`, `unknown` or `victim`.\n `sanctioned` and `ex_sanctioned` are reserved: a sanction comes only from the official lists.\n- `service_type`, `conflicting_tags` and `sanctions_history` are saved empty.\n\n**Response.** `{\"ok\": true, \"address\": …, \"label\": {…}, \"scope\": {…}}`, with the label as saved and the scope\nit was saved with.\n\n**Errors.** `400` if the address is not EVM, if the category is reserved or invalid, if `confidence` is out of\nrange, or if `X-Case-Id` does not match a case you can edit (the label is not saved). `422` if a field does not\nhave the expected shape.\n\n**Cost:** 1 credit.","operationId":"add_label_v1_labels_post","security":["f0df2cab-bdf3-49e2-881f-c2a678205a3e","fbef3a28-f906-477f-8f61-3a4ba6274c90"],"parameters":["08cfe948-4228-4bcc-ac35-d121cff2e15d"],"requestBody":"eab984f7-b1ab-4d78-bcb0-cd7899808ee5","responses":{"200":"6c3f6329-f208-40ff-85fb-2996dbb02b3e","401":"6a258409-01ee-48cc-a6ea-92742e943d6d","402":"311f0abc-01eb-4640-a85b-9bb9348f7376","422":"1de88655-11c1-43ff-8d0c-f10463b379b8","429":"7514136f-244c-4b9a-b326-5b1236e52887","503":"17816b54-7993-46a4-a594-850dac26e8da"},"x-credits":1,"x-mint":{"href":"/en/api-reference/post-v1-labels","metadata":{"sidebarTitle":"Contribute a private label"}},"method":"post","type":"path","servers":["0b74746d-1f18-411c-8e0d-6898708b243f"],"path":"/v1/labels","baseUrlOptions":["https://app.blockgence.com"],"title":"Contribute a private label","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"08cfe948-4228-4bcc-ac35-d121cff2e15d":{"name":"X-Case-Id","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"X-Case-Id","description":"Optional case the label is added to: the token of a case you can edit. Without this header, the label belongs to your API key. A case that does not exist or that you cannot edit returns `400` and the label is not saved.","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"X-Case-Id","description":"Optional case the label is added to: the token of a case you can edit. Without this header, the label belongs to your API key. A case that does not exist or that you cannot edit returns `400` and the label is not saved.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Optional case the label is added to: the token of a case you can edit. Without this header, the label belongs to your API key. A case that does not exist or that you cannot edit returns `400` and the label is not saved."}},"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":{"6c3f6329-f208-40ff-85fb-2996dbb02b3e":{"description":"Successful response.","content":{"application/json":{"schema":{}}},"exampleType":"generated"},"6a258409-01ee-48cc-a6ea-92742e943d6d":{"description":"The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"type":"object","title":"Error","description":"Common shape of errors: a readable `detail` and, in many cases, an `error` with a stable code to recognize it without parsing the text.","properties":{"detail":{"type":"string","description":"What happened, in one sentence.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"error":{"type":"string","description":"Stable error code, when there is one.","uniqueKey":"error","typeLabel":"string"}},"required":["detail"],"uniqueKey":"","typeLabel":"Error · object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"311f0abc-01eb-4640-a85b-9bb9348f7376":{"description":"The monthly credits are exhausted.","content":{"application/json":{"schema":{"type":"object","title":"Error","description":"Common shape of errors: a readable `detail` and, in many cases, an `error` with a stable code to recognize it without parsing the text.","properties":{"detail":{"type":"string","description":"What happened, in one sentence.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"error":{"type":"string","description":"Stable error code, when there is one.","uniqueKey":"error","typeLabel":"string"}},"required":["detail"],"uniqueKey":"","typeLabel":"Error · object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"1de88655-11c1-43ff-8d0c-f10463b379b8":{"description":"The request does not have the expected shape; `detail` states which field to correct.","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"},"7514136f-244c-4b9a-b326-5b1236e52887":{"description":"The per-minute request limit was exceeded. Retry after the number of seconds in `Retry-After`.","content":{"application/json":{"schema":{"type":"object","title":"Error","description":"Common shape of errors: a readable `detail` and, in many cases, an `error` with a stable code to recognize it without parsing the text.","properties":{"detail":{"type":"string","description":"What happened, in one sentence.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"error":{"type":"string","description":"Stable error code, when there is one.","uniqueKey":"error","typeLabel":"string"}},"required":["detail"],"uniqueKey":"","typeLabel":"Error · object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"17816b54-7993-46a4-a594-850dac26e8da":{"description":"`source_unavailable`: the data source could not read what was requested. No credits are charged. If an intermediate step fails, the response is 200 and declares it in `degraded_sources`.","content":{"application/json":{"schema":{"type":"object","title":"SourceUnavailable","description":"The data source could not read what was requested. No credits are charged. Missing data does not mean the address is risk-free or has no activity.","properties":{"error":{"type":"string","enum":["source_unavailable"],"isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"detail":{"type":"string","description":"What failed, where, and whether a retry is advisable.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"source":{"type":"string","description":"Source that could not respond, for example `etherscan` or `blockscout`.","isRequired":true,"uniqueKey":"source","typeLabel":"string"},"reason":{"type":"string","description":"Stable reason, for example `rate_limited`, `timeout` or `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":"blockgence read that did not complete.","uniqueKey":"primitive","typeLabel":"string"},"operation":{"type":"string","description":"Specific query to the source.","uniqueKey":"operation","typeLabel":"string"},"target":{"type":"string","description":"What was queried (address or transaction), abbreviated.","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":"Seconds to wait before retrying; also sent in the `Retry-After` header.","uniqueKey":"retry_after.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Seconds to wait before retrying; also sent in the `Retry-After` header.","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":"Whether the failure came from the source or from a limit of the query itself.","uniqueKey":"source_fault","typeLabel":"boolean"},"failure_cause":{"type":"string","description":"Cause of the failure, in one sentence.","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":{"f0df2cab-bdf3-49e2-881f-c2a678205a3e":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Your API key in the `X-API-Key` header.","scopes":[],"schemeName":"APIKeyHeader"}},"fbef3a28-f906-477f-8f61-3a4ba6274c90":{"BearerAuth":{"type":"http","scheme":"bearer","description":"The same API key as `Authorization: Bearer \u003ckey>`, as an alternative to `X-API-Key`.","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"0b74746d-1f18-411c-8e0d-6898708b243f":{"url":"https://app.blockgence.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Your API key in the `X-API-Key` header.","scopes":[],"schemeName":"APIKeyHeader"},"schema":{"title":"X-API-Key","type":"string","description":"Your API key in the `X-API-Key` header.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKeyHeader","name":"X-API-Key"}],"title":"APIKeyHeader"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"The same API key as `Authorization: Bearer \u003ckey>`, as an alternative to `X-API-Key`.","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"The same API key as `Authorization: Bearer \u003ckey>`, as an alternative to `X-API-Key`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.en.json"},"subdomain":"blockgence","siteName":"blockgence","title":"Contribute a private label - blockgence","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"es":{"href":"/es/api-reference/post-v1-labels","matchLevel":1},"en":{"href":"/en/api-reference/post-v1-labels","matchLevel":0}}},"lastModified":"2026-11-21T04:04:08.162Z","originalFileLocation":"en/api-reference/post-v1-labels.mdx","locale":"en"},"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=\"Saves a private label for an EVM address. Without X-Case-Id, the label belongs to your API key (or to your user, from the app); with X-Case-Id, to the case. Only requests with that scope see it, never other customers. Request body. A Label object with address (0x + 40 hex), chain, label, category, source and confidence. So that a contributed label cannot pose as another source, the server sets or limits these fields: - added_by and method are always saved as \u0026quot;user\u0026quot; and \u0026quot;heuristic\u0026quot;. - source is saved as \u0026quot;usuario: \u0026quot;, on one line and with up to 200 characters. - confidence: a number between 0 and 1 (default 0.5), saved with a maximum of 0.5, below any other source. - category: bridge, contract, darknet, exchange, mixer, scam, unknown or victim. sanctioned and ex_sanctioned are reserved: a sanction comes only from the official lists. - service_type, conflicting_tags and sanctions_history are saved empty. Response. {\u0026quot;ok\u0026quot;: true, \u0026quot;address\u0026quot;: …, \u0026quot;label\u0026quot;: {…}, \u0026quot;scope\u0026quot;: {…}}, with the label as saved and the scope it was saved with. Errors. 400 if the address is not EVM, if the category is reserved or invalid, if confidence is out of range, or if X-Case-Id does not match a case you can edit (the label is not saved). 422 if a field does not have the expected shape. Cost: 1 credit.\">\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=\"Contribute a private label - blockgence\">\u003cmeta data-mint-head property=\"og:description\" content=\"Saves a private label for an EVM address. Without X-Case-Id, the label belongs to your API key (or to your user, from the app); with X-Case-Id, to the case. Only requests with that scope see it, never other customers. Request body. A Label object with address (0x + 40 hex), chain, label, category, source and confidence. So that a contributed label cannot pose as another source, the server sets or limits these fields: - added_by and method are always saved as \u0026quot;user\u0026quot; and \u0026quot;heuristic\u0026quot;. - source is saved as \u0026quot;usuario: \u0026quot;, on one line and with up to 200 characters. - confidence: a number between 0 and 1 (default 0.5), saved with a maximum of 0.5, below any other source. - category: bridge, contract, darknet, exchange, mixer, scam, unknown or victim. sanctioned and ex_sanctioned are reserved: a sanction comes only from the official lists. - service_type, conflicting_tags and sanctions_history are saved empty. Response. {\u0026quot;ok\u0026quot;: true, \u0026quot;address\u0026quot;: …, \u0026quot;label\u0026quot;: {…}, \u0026quot;scope\u0026quot;: {…}}, with the label as saved and the scope it was saved with. Errors. 400 if the address is not EVM, if the category is reserved or invalid, if confidence is out of range, or if X-Case-Id does not match a case you can edit (the label is not saved). 422 if a field does not have the expected shape. Cost: 1 credit.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"blockgence\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.blockgence.com/en/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=Tracing\u0026amp;title=Contribute+a+private+label\u0026amp;description=Saves+a+private+label+for+an+EVM+address.+Without+%60X-Case-Id%60%2C+the+label+belongs+to+your+API+key+%28or+to+your%0Auser%2C+from+the+app%29%3B+with+%60X-Case-Id%60%2C+to+the+case.\u0026amp;theme=e9a290c1d076fc94b92b2551\u0026amp;signature=f1a99461a2b9bd83210ab7dff2564eceee1a02bbec093d41ba3e25b689b3f16f\">\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=\"Contribute a private label - blockgence\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Saves a private label for an EVM address. Without X-Case-Id, the label belongs to your API key (or to your user, from the app); with X-Case-Id, to the case. Only requests with that scope see it, never other customers. Request body. A Label object with address (0x + 40 hex), chain, label, category, source and confidence. So that a contributed label cannot pose as another source, the server sets or limits these fields: - added_by and method are always saved as \u0026quot;user\u0026quot; and \u0026quot;heuristic\u0026quot;. - source is saved as \u0026quot;usuario: \u0026quot;, on one line and with up to 200 characters. - confidence: a number between 0 and 1 (default 0.5), saved with a maximum of 0.5, below any other source. - category: bridge, contract, darknet, exchange, mixer, scam, unknown or victim. sanctioned and ex_sanctioned are reserved: a sanction comes only from the official lists. - service_type, conflicting_tags and sanctions_history are saved empty. Response. {\u0026quot;ok\u0026quot;: true, \u0026quot;address\u0026quot;: …, \u0026quot;label\u0026quot;: {…}, \u0026quot;scope\u0026quot;: {…}}, with the label as saved and the scope it was saved with. Errors. 400 if the address is not EVM, if the category is reserved or invalid, if confidence is out of range, or if X-Case-Id does not match a case you can edit (the label is not saved). 422 if a field does not have the expected shape. Cost: 1 credit.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://blockgence.mintlify.site/_mintlify/api/og/v2?division=Tracing\u0026amp;title=Contribute+a+private+label\u0026amp;description=Saves+a+private+label+for+an+EVM+address.+Without+%60X-Case-Id%60%2C+the+label+belongs+to+your+API+key+%28or+to+your%0Auser%2C+from+the+app%29%3B+with+%60X-Case-Id%60%2C+to+the+case.\u0026amp;theme=e9a290c1d076fc94b92b2551\u0026amp;signature=f1a99461a2b9bd83210ab7dff2564eceee1a02bbec093d41ba3e25b689b3f16f\">\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/en/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=\"/en/api-reference/post-v1-labels.md\">\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=\"es\" href=\"https://docs.blockgence.com/es/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/en/api-reference/post-v1-labels#webpage\",\"url\":\"https://docs.blockgence.com/en/api-reference/post-v1-labels\",\"name\":\"Contribute a private label\",\"description\":\"Saves a private label for an EVM address. Without X-Case-Id, the label belongs to your API key (or to your user, from the app); with X-Case-Id, to the case. Only requests with that scope see it, never other customers. Request body. A Label object with address (0x + 40 hex), chain, label, category, source and confidence. So that a contributed label cannot pose as another source, the server sets or limits these fields: - added_by and method are always saved as \\\"user\\\" and \\\"heuristic\\\". - source is saved as \\\"usuario: \\\", on one line and with up to 200 characters. - confidence: a number between 0 and 1 (default 0.5), saved with a maximum of 0.5, below any other source. - category: bridge, contract, darknet, exchange, mixer, scam, unknown or victim. sanctioned and ex_sanctioned are reserved: a sanction comes only from the official lists. - service_type, conflicting_tags and sanctions_history are saved empty. Response. {\\\"ok\\\": true, \\\"address\\\": …, \\\"label\\\": {…}, \\\"scope\\\": {…}}, with the label as saved and the scope it was saved with. Errors. 400 if the address is not EVM, if the category is reserved or invalid, if confidence is out of range, or if X-Case-Id does not match a case you can edit (the label is not saved). 422 if a field does not have the expected shape. Cost: 1 credit.\",\"dateModified\":\"2026-11-21T04:04:08.162Z\",\"isPartOf\":{\"@id\":\"https://docs.blockgence.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.blockgence.com/en/api-reference/post-v1-labels#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.blockgence.com/en/api-reference/post-v1-labels#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference\",\"item\":\"https://docs.blockgence.com/en/api/reference\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tracing\",\"item\":\"https://docs.blockgence.com/en/api-reference/post-v1-trace\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Contribute a private label\",\"item\":\"https://docs.blockgence.com/en/api-reference/post-v1-labels\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.blockgence.com/en/api-reference/post-v1-labels#apireference\",\"headline\":\"Contribute a private label\",\"name\":\"Contribute a private label\",\"description\":\"Saves a private label for an EVM address. Without X-Case-Id, the label belongs to your API key (or to your user, from the app); with X-Case-Id, to the case. Only requests with that scope see it, never other customers. Request body. A Label object with address (0x + 40 hex), chain, label, category, source and confidence. So that a contributed label cannot pose as another source, the server sets or limits these fields: - added_by and method are always saved as \\\"user\\\" and \\\"heuristic\\\". - source is saved as \\\"usuario: \\\", on one line and with up to 200 characters. - confidence: a number between 0 and 1 (default 0.5), saved with a maximum of 0.5, below any other source. - category: bridge, contract, darknet, exchange, mixer, scam, unknown or victim. sanctioned and ex_sanctioned are reserved: a sanction comes only from the official lists. - service_type, conflicting_tags and sanctions_history are saved empty. Response. {\\\"ok\\\": true, \\\"address\\\": …, \\\"label\\\": {…}, \\\"scope\\\": {…}}, with the label as saved and the scope it was saved with. Errors. 400 if the address is not EVM, if the category is reserved or invalid, if confidence is out of range, or if X-Case-Id does not match a case you can edit (the label is not saved). 422 if a field does not have the expected shape. Cost: 1 credit.\",\"url\":\"https://docs.blockgence.com/en/api-reference/post-v1-labels\",\"mainEntityOfPage\":{\"@id\":\"https://docs.blockgence.com/en/api-reference/post-v1-labels#webpage\"},\"dateModified\":\"2026-11-21T04:04:08.162Z\",\"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":"/en/api-reference/post-v1-labels.md","siteName":"blockgence","nav":{"global":null,"languages":[{"language":"es","default":true,"pages":[{"title":"es","href":"/es/api-reference/post-v1-labels"}]},{"language":"en","tabs":[{"tab":"Get started","pages":[{"title":"Get started","href":"/en/get-started/introduction"}]},{"tab":"API","groups":[{"group":"Guides","pages":[{"title":"Authentication","href":"/en/api/authentication"},{"title":"Errors","href":"/en/api/errors"},{"title":"Pagination and cutoffs","href":"/en/api/pagination-and-cutoffs"},{"title":"API changelog","href":"/en/api/changelog"}]},{"group":"Reference","pages":[{"title":"Reading the reference","href":"/en/api/reference"},{"group":"Service","pages":[{"title":"Service status","deprecated":null,"version":null,"sidebarTitle":"Service status","openapi":"/openapi.en.json get /health","href":"/en/api-reference/get-health"}]},{"group":"Tracing","pages":[{"title":"Trace the flow of funds from an address","deprecated":null,"version":null,"sidebarTitle":"Trace the flow of funds from an address","openapi":"/openapi.en.json post /v1/trace","href":"/en/api-reference/post-v1-trace"},{"title":"Risk and exposure summary of a trace","deprecated":null,"version":null,"sidebarTitle":"Risk and exposure summary of a trace","openapi":"/openapi.en.json post /v1/report","href":"/en/api-reference/post-v1-report"},{"title":"Sealed evidence package of a trace","deprecated":null,"version":null,"sidebarTitle":"Sealed evidence package of a trace","openapi":"/openapi.en.json post /v1/evidence","href":"/en/api-reference/post-v1-evidence"},{"title":"PDF report of an evidence package","deprecated":null,"version":null,"sidebarTitle":"PDF report of an evidence package","openapi":"/openapi.en.json post /v1/evidence/report.pdf","href":"/en/api-reference/post-v1-evidence-report-pdf"},{"title":"Labels, risk and sanctions of an address","deprecated":null,"version":null,"sidebarTitle":"Labels, risk and sanctions of an address","openapi":"/openapi.en.json get /v1/address/{addr}","href":"/en/api-reference/get-v1-address-addr"},{"title":"On-chain profile and counterparties of an address","deprecated":null,"version":null,"sidebarTitle":"On-chain profile and counterparties of an address","openapi":"/openapi.en.json get /v1/enrich/{addr}","href":"/en/api-reference/get-v1-enrich-addr"},{"title":"Initial funding source of an address","deprecated":null,"version":null,"sidebarTitle":"Initial funding source of an address","openapi":"/openapi.en.json get /v1/funding/{addr}","href":"/en/api-reference/get-v1-funding-addr"},{"title":"Networks with activity for an address","deprecated":null,"version":null,"sidebarTitle":"Networks with activity for an address","openapi":"/openapi.en.json get /v1/probe/{addr}","href":"/en/api-reference/get-v1-probe-addr"},{"title":"On-chain messages of an address","deprecated":null,"version":null,"sidebarTitle":"On-chain messages of an address","openapi":"/openapi.en.json get /v1/messages/{addr}","href":"/en/api-reference/get-v1-messages-addr"},{"title":"Mentions of an address on the open web","deprecated":null,"version":null,"sidebarTitle":"Mentions of an address on the open web","openapi":"/openapi.en.json get /v1/osint/{addr}","href":"/en/api-reference/get-v1-osint-addr"},{"title":"Link Tornado Cash deposits and withdrawals","deprecated":null,"version":null,"sidebarTitle":"Link Tornado Cash deposits and withdrawals","openapi":"/openapi.en.json get /v1/demix/{addr}","href":"/en/api-reference/get-v1-demix-addr"},{"title":"Compare the operational fingerprint of several addresses (experimental)","deprecated":null,"version":null,"sidebarTitle":"Compare the operational fingerprint of several addresses (experimental)","openapi":"/openapi.en.json get /v1/fingerprint/{chain}","href":"/en/api-reference/get-v1-fingerprint-chain"},{"title":"Context links of an address (experimental)","deprecated":null,"version":null,"sidebarTitle":"Context links of an address (experimental)","openapi":"/openapi.en.json get /v1/cluster/{chain}/{addr}","href":"/en/api-reference/get-v1-cluster-chain-addr"},{"title":"Movements of a transaction","deprecated":null,"version":null,"sidebarTitle":"Movements of a transaction","openapi":"/openapi.en.json get /v1/tx/{txhash}","href":"/en/api-reference/get-v1-tx-txhash"},{"title":"Resolve ENS names for several addresses","deprecated":null,"version":null,"sidebarTitle":"Resolve ENS names for several addresses","openapi":"/openapi.en.json post /v1/ens","href":"/en/api-reference/post-v1-ens"},{"title":"All counterparties of an address","deprecated":null,"version":null,"sidebarTitle":"All counterparties of an address","openapi":"/openapi.en.json post /v1/counterparties","href":"/en/api-reference/post-v1-counterparties"},{"title":"Find the path of funds between two addresses","deprecated":null,"version":null,"sidebarTitle":"Find the path of funds between two addresses","openapi":"/openapi.en.json post /v1/path","href":"/en/api-reference/post-v1-path"},{"title":"Follow a bridge crossing to the destination network","deprecated":null,"version":null,"sidebarTitle":"Follow a bridge crossing to the destination network","openapi":"/openapi.en.json post /v1/stitch","href":"/en/api-reference/post-v1-stitch"},{"title":"Follow value through a swap","deprecated":null,"version":null,"sidebarTitle":"Follow value through a swap","openapi":"/openapi.en.json post /v1/unswap","href":"/en/api-reference/post-v1-unswap"},{"title":"Known labels of an address","description":"Returns the labels of an address: the public ones (sanctions lists, entity registries and community dataset)\nand the private ones visible to the request (those of your API key and, with `X-Case-Id`, those of the case).\nIt never includes labels contributed by other customers.\n\n**With `chain`.** Each label is shown as it applies on that network: a label published for another network\ncarries `chain_basis` (why it applies, or not) or is returned as context. The address is validated as in\n`GET /v1/address/{addr}` (EVM, Tron or Monero).\n\n**Without `chain`.** Returns the full index listing, each row with the network it was published for. It is not\nthe identity of the address on a specific network.\n\n**Response.** A list of `Label` objects: `address`, `chain`, `label`, `category`, `source`, `confidence`,\n`method`, `added_by`, `service_type`, `conflicting_tags`, `sanctions_history` and `chain_basis`. A label with\n`added_by: \"user\"` is one contributed by your API key.\n\n**Cost:** 1 credit.","deprecated":null,"version":null,"sidebarTitle":"Known labels of an address","openapi":"/openapi.en.json get /v1/labels/{addr}","href":"/en/api-reference/get-v1-labels-addr"},{"title":"Contribute a private label","deprecated":null,"version":null,"sidebarTitle":"Contribute a private label","openapi":"/openapi.en.json post /v1/labels","href":"/en/api-reference/post-v1-labels"}]},{"group":"Incidents","pages":[{"title":"Address poisoning","description":"Checks a victim's history for address poisoning: addresses that resemble the victim's legitimate\ncounterparties (same first and last characters) and sent the victim zero-value transfers, counterfeit tokens or\nminimal amounts shortly after a real transfer, and whether the victim later sent funds to them.\n\nEach row of `lookalikes` is a lookalike address, compared with the legitimate counterparty that best explains it\n(`lookalike_of`). It includes `prefix_len`, `suffix_len`, the seedings (`seeds`, with their `kind` and\n`timing`), the losses (`losses`, with their USD value at the date), `loss_usd`, `reasons` and `status`:\n- `poisoning_with_loss`: poisoning pattern, and the victim sent funds to the lookalike address;\n- `poisoning_attempt`: poisoning pattern, without a loss;\n- `lookalike_without_timing`: the address is similar, but no seeding coincides in time with a legitimate\n transfer. Poisoning is not asserted.\n\nThe loss is an on-chain fact; that it was a poisoning is an inference. `summary` summarizes the result and\n`coverage.complete: false` indicates that the history read is incomplete.\n\nEVM networks only. An invalid address or window returns 400, at no charge. On some networks the full history is\nnot available: the response is 503, at no charge, and you should narrow the window with `from_block`. It does\nnot cover Tron, internal native transfers, lookalikes of addresses that sent funds to the victim, or seedings\nwith NFTs (`not_covered`).\n\n**Cost:** 5 credits base. Some operations charge less when they reuse a saved result; never more.","deprecated":null,"version":null,"sidebarTitle":"Address poisoning","openapi":"/openapi.en.json get /v1/poisoning/{chain}/{addr}","href":"/en/api-reference/get-v1-poisoning-chain-addr"},{"title":"Drainer victims","deprecated":null,"version":null,"sidebarTitle":"Drainer victims","openapi":"/openapi.en.json get /v1/drainer/{chain}/{addr}/victims","href":"/en/api-reference/get-v1-drainer-chain-addr-victims"},{"title":"Scammer victims","deprecated":null,"version":null,"sidebarTitle":"Scammer victims","openapi":"/openapi.en.json get /v1/scam/{chain}/{addr}/victims","href":"/en/api-reference/get-v1-scam-chain-addr-victims"},{"title":"Address holdings at a date","deprecated":null,"version":null,"sidebarTitle":"Address holdings at a date","openapi":"/openapi.en.json get /v1/holdings/{chain}/{addr}","href":"/en/api-reference/get-v1-holdings-chain-addr"},{"title":"Address status with stablecoin issuers","deprecated":null,"version":null,"sidebarTitle":"Address status with stablecoin issuers","openapi":"/openapi.en.json get /v1/issuer-status/{chain}/{addr}","href":"/en/api-reference/get-v1-issuer-status-chain-addr"},{"title":"Failed attacker attempts","deprecated":null,"version":null,"sidebarTitle":"Failed attacker attempts","openapi":"/openapi.en.json get /v1/attempts/{chain}/{addr}","href":"/en/api-reference/get-v1-attempts-chain-addr"},{"title":"Freeze pack for the authority","deprecated":null,"version":null,"sidebarTitle":"Freeze pack for the authority","openapi":"/openapi.en.json get /v1/freezepack/{case_token}","href":"/en/api-reference/get-v1-freezepack-case-token"},{"title":"Decode a transaction","deprecated":null,"version":null,"sidebarTitle":"Decode a transaction","openapi":"/openapi.en.json get /v1/decode/{chain}/{hash}","href":"/en/api-reference/get-v1-decode-chain-hash"},{"title":"Incident fund returns","deprecated":null,"version":null,"sidebarTitle":"Incident fund returns","openapi":"/openapi.en.json post /v1/returns","href":"/en/api-reference/post-v1-returns"},{"title":"SEAL Safe Harbor agreement for an address","deprecated":null,"version":null,"sidebarTitle":"SEAL Safe Harbor agreement for an address","openapi":"/openapi.en.json get /v1/safe-harbor/{chain}/{addr}","href":"/en/api-reference/get-v1-safe-harbor-chain-addr"},{"title":"Start the incident playbook","deprecated":null,"version":null,"sidebarTitle":"Start the incident playbook","openapi":"/openapi.en.json post /v1/incident","href":"/en/api-reference/post-v1-incident"},{"title":"Incident playbook job status","deprecated":null,"version":null,"sidebarTitle":"Incident playbook job status","openapi":"/openapi.en.json get /v1/incident/{job_id}","href":"/en/api-reference/get-v1-incident-job-id"},{"title":"Incident post-mortem","deprecated":null,"version":null,"sidebarTitle":"Incident post-mortem","openapi":"/openapi.en.json get /v1/postmortem/{case_token}","href":"/en/api-reference/get-v1-postmortem-case-token"},{"title":"Incident deliverable","deprecated":null,"version":null,"sidebarTitle":"Incident deliverable","openapi":"/openapi.en.json get /v1/deliverable/{case_token}","href":"/en/api-reference/get-v1-deliverable-case-token"},{"title":"Victim triage","deprecated":null,"version":null,"sidebarTitle":"Victim triage","openapi":"/openapi.en.json post /v1/triage","href":"/en/api-reference/post-v1-triage"},{"title":"Trace from the loss transaction","deprecated":null,"version":null,"sidebarTitle":"Trace from the loss transaction","openapi":"/openapi.en.json post /v1/tracetx","href":"/en/api-reference/post-v1-tracetx"},{"title":"List tracked hacks","deprecated":null,"version":null,"sidebarTitle":"List tracked hacks","openapi":"/openapi.en.json get /v1/tracker","href":"/en/api-reference/get-v1-tracker"},{"title":"Track a hack","deprecated":null,"version":null,"sidebarTitle":"Track a hack","openapi":"/openapi.en.json post /v1/tracker","href":"/en/api-reference/post-v1-tracker"},{"title":"Status of a hack's stolen funds","deprecated":null,"version":null,"sidebarTitle":"Status of a hack's stolen funds","openapi":"/openapi.en.json get /v1/tracker/{tracker_id}","href":"/en/api-reference/get-v1-tracker-tracker-id"},{"title":"Recalculate the funds' status","deprecated":null,"version":null,"sidebarTitle":"Recalculate the funds' status","openapi":"/openapi.en.json post /v1/tracker/{tracker_id}/recompute","href":"/en/api-reference/post-v1-tracker-tracker-id-recompute"},{"title":"Most frequent attack vectors","deprecated":null,"version":null,"sidebarTitle":"Most frequent attack vectors","openapi":"/openapi.en.json get /v1/attack-vectors","href":"/en/api-reference/get-v1-attack-vectors"},{"title":"Weekly laundering pulse","deprecated":null,"version":null,"sidebarTitle":"Weekly laundering pulse","openapi":"/openapi.en.json get /v1/laundering-pulse","href":"/en/api-reference/get-v1-laundering-pulse"}]},{"group":"Cases","pages":[{"title":"List cases","deprecated":null,"version":null,"sidebarTitle":"List cases","openapi":"/openapi.en.json get /v1/cases","href":"/en/api-reference/get-v1-cases"},{"title":"Create a case","deprecated":null,"version":null,"sidebarTitle":"Create a case","openapi":"/openapi.en.json post /v1/cases","href":"/en/api-reference/post-v1-cases"},{"title":"Import a case file","deprecated":null,"version":null,"sidebarTitle":"Import a case file","openapi":"/openapi.en.json post /v1/cases/import","href":"/en/api-reference/post-v1-cases-import"},{"title":"List invitations from other organizations","deprecated":null,"version":null,"sidebarTitle":"List invitations from other organizations","openapi":"/openapi.en.json get /v1/cases/invitations","href":"/en/api-reference/get-v1-cases-invitations"},{"title":"Accept an invitation from another organization","deprecated":null,"version":null,"sidebarTitle":"Accept an invitation from another organization","openapi":"/openapi.en.json post /v1/cases/invitations/{share_id}/accept","href":"/en/api-reference/post-v1-cases-invitations-share-id-accept"},{"title":"Decline an invitation from another organization","deprecated":null,"version":null,"sidebarTitle":"Decline an invitation from another organization","openapi":"/openapi.en.json post /v1/cases/invitations/{share_id}/decline","href":"/en/api-reference/post-v1-cases-invitations-share-id-decline"},{"title":"Get a case","deprecated":null,"version":null,"sidebarTitle":"Get a case","openapi":"/openapi.en.json get /v1/cases/{token}","href":"/en/api-reference/get-v1-cases-token"},{"title":"Save a case","deprecated":null,"version":null,"sidebarTitle":"Save a case","openapi":"/openapi.en.json put /v1/cases/{token}","href":"/en/api-reference/put-v1-cases-token"},{"title":"Delete a case","deprecated":null,"version":null,"sidebarTitle":"Delete a case","openapi":"/openapi.en.json delete /v1/cases/{token}","href":"/en/api-reference/delete-v1-cases-token"},{"title":"Case chain of custody","deprecated":null,"version":null,"sidebarTitle":"Case chain of custody","openapi":"/openapi.en.json get /v1/cases/{token}/activity","href":"/en/api-reference/get-v1-cases-token-activity"},{"title":"List who a case is shared with","deprecated":null,"version":null,"sidebarTitle":"List who a case is shared with","openapi":"/openapi.en.json get /v1/cases/{token}/shares","href":"/en/api-reference/get-v1-cases-token-shares"},{"title":"Share a case within the organization","deprecated":null,"version":null,"sidebarTitle":"Share a case within the organization","openapi":"/openapi.en.json post /v1/cases/{token}/shares","href":"/en/api-reference/post-v1-cases-token-shares"},{"title":"Share a case with another organization","deprecated":null,"version":null,"sidebarTitle":"Share a case with another organization","openapi":"/openapi.en.json post /v1/cases/{token}/external-shares","href":"/en/api-reference/post-v1-cases-token-external-shares"},{"title":"Revoke access for another organization","deprecated":null,"version":null,"sidebarTitle":"Revoke access for another organization","openapi":"/openapi.en.json delete /v1/cases/{token}/external-shares/{share_id}","href":"/en/api-reference/delete-v1-cases-token-external-shares-share-id"},{"title":"Stop viewing a case of another organization","deprecated":null,"version":null,"sidebarTitle":"Stop viewing a case of another organization","openapi":"/openapi.en.json delete /v1/cases/{token}/external-access","href":"/en/api-reference/delete-v1-cases-token-external-access"},{"title":"Stop sharing a case","deprecated":null,"version":null,"sidebarTitle":"Stop sharing a case","openapi":"/openapi.en.json delete /v1/cases/{token}/shares/{share_id}","href":"/en/api-reference/delete-v1-cases-token-shares-share-id"},{"title":"List the annotations of a case","deprecated":null,"version":null,"sidebarTitle":"List the annotations of a case","openapi":"/openapi.en.json get /v1/cases/{token}/annotations","href":"/en/api-reference/get-v1-cases-token-annotations"},{"title":"Add an annotation to a case","deprecated":null,"version":null,"sidebarTitle":"Add an annotation to a case","openapi":"/openapi.en.json post /v1/cases/{token}/annotations","href":"/en/api-reference/post-v1-cases-token-annotations"},{"title":"Remove an annotation from a case","deprecated":null,"version":null,"sidebarTitle":"Remove an annotation from a case","openapi":"/openapi.en.json delete /v1/cases/{token}/annotations/{annotation_id}","href":"/en/api-reference/delete-v1-cases-token-annotations-annotation-id"},{"title":"Overlaps with other cases","deprecated":null,"version":null,"sidebarTitle":"Overlaps with other cases","openapi":"/openapi.en.json get /v1/cases/{token}/overlaps","href":"/en/api-reference/get-v1-cases-token-overlaps"},{"title":"Case change log","deprecated":null,"version":null,"sidebarTitle":"Case change log","openapi":"/openapi.en.json get /v1/cases/{token}/changes","href":"/en/api-reference/get-v1-cases-token-changes"},{"title":"Case evidence package","deprecated":null,"version":null,"sidebarTitle":"Case evidence package","openapi":"/openapi.en.json get /v1/cases/{token}/evidence","href":"/en/api-reference/get-v1-cases-token-evidence"},{"title":"Evidence package and PDF report in a ZIP","deprecated":null,"version":null,"sidebarTitle":"Evidence package and PDF report in a ZIP","openapi":"/openapi.en.json get /v1/cases/{token}/evidence.zip","href":"/en/api-reference/get-v1-cases-token-evidence-zip"},{"title":"Case off-ramps","deprecated":null,"version":null,"sidebarTitle":"Case off-ramps","openapi":"/openapi.en.json get /v1/cases/{token}/offramps","href":"/en/api-reference/get-v1-cases-token-offramps"},{"title":"Case off-ramps in CSV","deprecated":null,"version":null,"sidebarTitle":"Case off-ramps in CSV","openapi":"/openapi.en.json get /v1/cases/{token}/offramps.csv","href":"/en/api-reference/get-v1-cases-token-offramps-csv"},{"title":"Suspicious activity report draft","deprecated":null,"version":null,"sidebarTitle":"Suspicious activity report draft","openapi":"/openapi.en.json get /v1/cases/{token}/report/{kind}","href":"/en/api-reference/get-v1-cases-token-report-kind"},{"title":"Export a case file","deprecated":null,"version":null,"sidebarTitle":"Export a case file","openapi":"/openapi.en.json get /v1/cases/{token}/export","href":"/en/api-reference/get-v1-cases-token-export"},{"title":"IVMS 101 record for case transactions","deprecated":null,"version":null,"sidebarTitle":"IVMS 101 record for case transactions","openapi":"/openapi.en.json get /v1/cases/{token}/ivms101","href":"/en/api-reference/get-v1-cases-token-ivms101"}]},{"group":"Travel Rule","pages":[{"title":"Ownership challenge","deprecated":null,"version":null,"sidebarTitle":"Ownership challenge","openapi":"/openapi.en.json post /v1/travel-rule/challenge","href":"/en/api-reference/post-v1-travel-rule-challenge"},{"title":"Address counterparty","deprecated":null,"version":null,"sidebarTitle":"Address counterparty","openapi":"/openapi.en.json post /v1/travel-rule/counterparty","href":"/en/api-reference/post-v1-travel-rule-counterparty"},{"title":"Reconcile a Travel Rule message","deprecated":null,"version":null,"sidebarTitle":"Reconcile a Travel Rule message","openapi":"/openapi.en.json post /v1/travel-rule/reconcile","href":"/en/api-reference/post-v1-travel-rule-reconcile"},{"title":"Validate an IVMS101 message","deprecated":null,"version":null,"sidebarTitle":"Validate an IVMS101 message","openapi":"/openapi.en.json post /v1/travel-rule/ivms101/validate","href":"/en/api-reference/post-v1-travel-rule-ivms101-validate"}]},{"group":"Monero","pages":[{"title":"Monero transaction profile","deprecated":null,"version":null,"sidebarTitle":"Monero transaction profile","openapi":"/openapi.en.json get /v1/monero/tx/{txid}","href":"/en/api-reference/get-v1-monero-tx-txid"},{"title":"Verify a Monero payment","deprecated":null,"version":null,"sidebarTitle":"Verify a Monero payment","openapi":"/openapi.en.json post /v1/monero/proof","href":"/en/api-reference/post-v1-monero-proof"}]},{"group":"Platform","pages":[{"title":"Networks and capabilities","deprecated":null,"version":null,"sidebarTitle":"Networks and capabilities","openapi":"/openapi.en.json get /v1/chains","href":"/en/api-reference/get-v1-chains"},{"title":"A network and its capabilities","deprecated":null,"version":null,"sidebarTitle":"A network and its capabilities","openapi":"/openapi.en.json get /v1/chains/{chain}","href":"/en/api-reference/get-v1-chains-chain"},{"title":"Data sources and their status","deprecated":null,"version":null,"sidebarTitle":"Data sources and their status","openapi":"/openapi.en.json get /v1/sources","href":"/en/api-reference/get-v1-sources"},{"title":"Sanctions lists","deprecated":null,"version":null,"sidebarTitle":"Sanctions lists","openapi":"/openapi.en.json get /v1/sanctions/lists","href":"/en/api-reference/get-v1-sanctions-lists"},{"title":"Published methodology","deprecated":null,"version":null,"sidebarTitle":"Published methodology","openapi":"/openapi.en.json get /v1/methodology","href":"/en/api-reference/get-v1-methodology"},{"title":"A methodology entry","deprecated":null,"version":null,"sidebarTitle":"A methodology entry","openapi":"/openapi.en.json get /v1/methodology/{entry_id}","href":"/en/api-reference/get-v1-methodology-entry-id"}]},{"group":"Permissions","pages":[{"title":"Permissions granted by an address","deprecated":null,"version":null,"sidebarTitle":"Permissions granted by an address","openapi":"/openapi.en.json get /v1/approvals/{chain}/{addr}","href":"/en/api-reference/get-v1-approvals-chain-addr"},{"title":"Permissions granted to a spender","deprecated":null,"version":null,"sidebarTitle":"Permissions granted to a spender","openapi":"/openapi.en.json get /v1/approvals-by-spender/{chain}/{spender}","href":"/en/api-reference/get-v1-approvals-by-spender-chain-spender"},{"title":"Outflows in third-party transactions","deprecated":null,"version":null,"sidebarTitle":"Outflows in third-party transactions","openapi":"/openapi.en.json get /v1/signature-drains/{chain}/{addr}","href":"/en/api-reference/get-v1-signature-drains-chain-addr"},{"title":"Outflows in third-party transactions, quick view","deprecated":null,"version":null,"sidebarTitle":"Outflows in third-party transactions, quick view","openapi":"/openapi.en.json get /v1/third-party-outflows/{chain}/{addr}","href":"/en/api-reference/get-v1-third-party-outflows-chain-addr"},{"title":"EIP-7702 delegations","deprecated":null,"version":null,"sidebarTitle":"EIP-7702 delegations","openapi":"/openapi.en.json get /v1/delegation/{addr}","href":"/en/api-reference/get-v1-delegation-addr"}]},{"group":"Compromise","pages":[{"title":"Compromise vector","deprecated":null,"version":null,"sidebarTitle":"Compromise vector","openapi":"/openapi.en.json post /v1/compromise","href":"/en/api-reference/post-v1-compromise"}]},{"group":"Contracts","pages":[{"title":"Contract inspection","deprecated":null,"version":null,"sidebarTitle":"Contract inspection","openapi":"/openapi.en.json get /v1/contract/{chain}/{addr}","href":"/en/api-reference/get-v1-contract-chain-addr"},{"title":"Simulate a transaction","deprecated":null,"version":null,"sidebarTitle":"Simulate a transaction","openapi":"/openapi.en.json post /v1/simulate","href":"/en/api-reference/post-v1-simulate"}]},{"group":"Guard","pages":[{"title":"Guard status","deprecated":null,"version":null,"sidebarTitle":"Guard status","openapi":"/openapi.en.json get /v1/guard/status","href":"/en/api-reference/get-v1-guard-status"},{"title":"List watches","deprecated":null,"version":null,"sidebarTitle":"List watches","openapi":"/openapi.en.json get /v1/guard/watches","href":"/en/api-reference/get-v1-guard-watches"},{"title":"Create a watch","deprecated":null,"version":null,"sidebarTitle":"Create a watch","openapi":"/openapi.en.json post /v1/guard/watches","href":"/en/api-reference/post-v1-guard-watches"},{"title":"Get a watch","deprecated":null,"version":null,"sidebarTitle":"Get a watch","openapi":"/openapi.en.json get /v1/guard/watches/{wid}","href":"/en/api-reference/get-v1-guard-watches-wid"},{"title":"Delete a watch","deprecated":null,"version":null,"sidebarTitle":"Delete a watch","openapi":"/openapi.en.json delete /v1/guard/watches/{wid}","href":"/en/api-reference/delete-v1-guard-watches-wid"},{"title":"Update a watch","deprecated":null,"version":null,"sidebarTitle":"Update a watch","openapi":"/openapi.en.json patch /v1/guard/watches/{wid}","href":"/en/api-reference/patch-v1-guard-watches-wid"},{"title":"List a watch's activity","deprecated":null,"version":null,"sidebarTitle":"List a watch's activity","openapi":"/openapi.en.json get /v1/guard/watches/{wid}/events","href":"/en/api-reference/get-v1-guard-watches-wid-events"},{"title":"Derived watch tree","deprecated":null,"version":null,"sidebarTitle":"Derived watch tree","openapi":"/openapi.en.json get /v1/guard/watches/{wid}/hops","href":"/en/api-reference/get-v1-guard-watches-wid-hops"},{"title":"List alerts","deprecated":null,"version":null,"sidebarTitle":"List alerts","openapi":"/openapi.en.json get /v1/guard/alerts","href":"/en/api-reference/get-v1-guard-alerts"},{"title":"Get an alert","deprecated":null,"version":null,"sidebarTitle":"Get an alert","openapi":"/openapi.en.json get /v1/guard/alerts/{aid}","href":"/en/api-reference/get-v1-guard-alerts-aid"},{"title":"Operate an alert","deprecated":null,"version":null,"sidebarTitle":"Operate an alert","openapi":"/openapi.en.json patch /v1/guard/alerts/{aid}","href":"/en/api-reference/patch-v1-guard-alerts-aid"},{"title":"Open a case from an alert","deprecated":null,"version":null,"sidebarTitle":"Open a case from an alert","openapi":"/openapi.en.json post /v1/guard/alerts/{aid}/case","href":"/en/api-reference/post-v1-guard-alerts-aid-case"},{"title":"List protocols","deprecated":null,"version":null,"sidebarTitle":"List protocols","openapi":"/openapi.en.json get /v1/guard/protocols","href":"/en/api-reference/get-v1-guard-protocols"},{"title":"Register a protocol","deprecated":null,"version":null,"sidebarTitle":"Register a protocol","openapi":"/openapi.en.json post /v1/guard/protocols","href":"/en/api-reference/post-v1-guard-protocols"},{"title":"Get a protocol","deprecated":null,"version":null,"sidebarTitle":"Get a protocol","openapi":"/openapi.en.json get /v1/guard/protocols/{pid}","href":"/en/api-reference/get-v1-guard-protocols-pid"},{"title":"Delete a protocol","deprecated":null,"version":null,"sidebarTitle":"Delete a protocol","openapi":"/openapi.en.json delete /v1/guard/protocols/{pid}","href":"/en/api-reference/delete-v1-guard-protocols-pid"},{"title":"Update a protocol","deprecated":null,"version":null,"sidebarTitle":"Update a protocol","openapi":"/openapi.en.json patch /v1/guard/protocols/{pid}","href":"/en/api-reference/patch-v1-guard-protocols-pid"},{"title":"Events in a contract's verified ABI","deprecated":null,"version":null,"sidebarTitle":"Events in a contract's verified ABI","openapi":"/openapi.en.json get /v1/guard/protocols/{pid}/abi-events","href":"/en/api-reference/get-v1-guard-protocols-pid-abi-events"},{"title":"List assignable people","deprecated":null,"version":null,"sidebarTitle":"List assignable people","openapi":"/openapi.en.json get /v1/guard/members","href":"/en/api-reference/get-v1-guard-members"},{"title":"Notification settings","deprecated":null,"version":null,"sidebarTitle":"Notification settings","openapi":"/openapi.en.json get /v1/guard/notifications","href":"/en/api-reference/get-v1-guard-notifications"},{"title":"Create a webhook","deprecated":null,"version":null,"sidebarTitle":"Create a webhook","openapi":"/openapi.en.json post /v1/guard/webhooks","href":"/en/api-reference/post-v1-guard-webhooks"},{"title":"Delete a webhook","deprecated":null,"version":null,"sidebarTitle":"Delete a webhook","openapi":"/openapi.en.json delete /v1/guard/webhooks/{hid}","href":"/en/api-reference/delete-v1-guard-webhooks-hid"},{"title":"Update a webhook","deprecated":null,"version":null,"sidebarTitle":"Update a webhook","openapi":"/openapi.en.json patch /v1/guard/webhooks/{hid}","href":"/en/api-reference/patch-v1-guard-webhooks-hid"},{"title":"Send a test message","deprecated":null,"version":null,"sidebarTitle":"Send a test message","openapi":"/openapi.en.json post /v1/guard/webhooks/{hid}/test","href":"/en/api-reference/post-v1-guard-webhooks-hid-test"},{"title":"List webhook deliveries","deprecated":null,"version":null,"sidebarTitle":"List webhook deliveries","openapi":"/openapi.en.json get /v1/guard/webhooks/{hid}/deliveries","href":"/en/api-reference/get-v1-guard-webhooks-hid-deliveries"},{"title":"Configure the email digest","deprecated":null,"version":null,"sidebarTitle":"Configure the email digest","openapi":"/openapi.en.json put /v1/guard/email","href":"/en/api-reference/put-v1-guard-email"}]},{"group":"Tokens","pages":[{"title":"Token profile","deprecated":null,"version":null,"sidebarTitle":"Token profile","openapi":"/openapi.en.json get /v1/token/{chain}/{addr}","href":"/en/api-reference/get-v1-token-chain-addr"}]},{"group":"Audit","pages":[{"title":"List your organization's audits","deprecated":null,"version":null,"sidebarTitle":"List your organization's audits","openapi":"/openapi.en.json get /v1/audit","href":"/en/api-reference/get-v1-audit"},{"title":"Request a smart contract review","deprecated":null,"version":null,"sidebarTitle":"Request a smart contract review","openapi":"/openapi.en.json post /v1/audit","href":"/en/api-reference/post-v1-audit"},{"title":"Summary of an audit","deprecated":null,"version":null,"sidebarTitle":"Summary of an audit","openapi":"/openapi.en.json get /v1/audit/{audit_id}","href":"/en/api-reference/get-v1-audit-audit-id"},{"title":"Ask the copilot of an audit","deprecated":null,"version":null,"sidebarTitle":"Ask the copilot of an audit","openapi":"/openapi.en.json post /v1/audit/{audit_id}/copilot","href":"/en/api-reference/post-v1-audit-audit-id-copilot"},{"title":"Requests registered by the copilot","deprecated":null,"version":null,"sidebarTitle":"Requests registered by the copilot","openapi":"/openapi.en.json get /v1/audit/{audit_id}/requests","href":"/en/api-reference/get-v1-audit-audit-id-requests"},{"title":"A section of an audit","deprecated":null,"version":null,"sidebarTitle":"A section of an audit","openapi":"/openapi.en.json get /v1/audit/{audit_id}/{section}","href":"/en/api-reference/get-v1-audit-audit-id-section"},{"title":"Load the deployed addresses of a review","deprecated":null,"version":null,"sidebarTitle":"Load the deployed addresses of a review","openapi":"/openapi.en.json post /v1/audit/{audit_id}/deploy","href":"/en/api-reference/post-v1-audit-audit-id-deploy"},{"title":"Add a team note","deprecated":null,"version":null,"sidebarTitle":"Add a team note","openapi":"/openapi.en.json post /v1/audit/{audit_id}/notes","href":"/en/api-reference/post-v1-audit-audit-id-notes"},{"title":"Remove a team note","deprecated":null,"version":null,"sidebarTitle":"Remove a team note","openapi":"/openapi.en.json delete /v1/audit/{audit_id}/notes/{note_id}","href":"/en/api-reference/delete-v1-audit-audit-id-notes-note-id"}]},{"group":"Copilot","pages":[{"title":"Investigation copilot","deprecated":null,"version":null,"sidebarTitle":"Investigation copilot","openapi":"/openapi.en.json post /v1/copilot","href":"/en/api-reference/post-v1-copilot"}]},{"group":"Screening","pages":[{"title":"Address screening","deprecated":null,"version":null,"sidebarTitle":"Address screening","openapi":"/openapi.en.json get /v1/screening/{addr}","href":"/en/api-reference/get-v1-screening-addr"},{"title":"Contract and address security","deprecated":null,"version":null,"sidebarTitle":"Contract and address security","openapi":"/openapi.en.json get /v1/security/{addr}","href":"/en/api-reference/get-v1-security-addr"}]},{"group":"Account","pages":[{"title":"Usage and limits","deprecated":null,"version":null,"sidebarTitle":"Usage and limits","openapi":"/openapi.en.json get /v1/account","href":"/en/api-reference/get-v1-account"}]},{"group":"Icons","pages":[{"title":"Entity logo by name","deprecated":null,"version":null,"sidebarTitle":"Entity logo by name","openapi":"/openapi.en.json get /v1/icon/named/{slug}.png","href":"/en/api-reference/get-v1-icon-named-slug-png"},{"title":"Token or contract logo","deprecated":null,"version":null,"sidebarTitle":"Token or contract logo","openapi":"/openapi.en.json get /v1/icon/{chain}/{address}.png","href":"/en/api-reference/get-v1-icon-chain-address-png"}]},{"group":"Evidence","pages":[{"title":"Public signing key","deprecated":null,"version":null,"sidebarTitle":"Public signing key","openapi":"/openapi.en.json get /v1/evidence/signing-key","href":"/en/api-reference/get-v1-evidence-signing-key"},{"title":"Document timestamp","deprecated":null,"version":null,"sidebarTitle":"Document timestamp","openapi":"/openapi.en.json get /v1/evidence/timestamp/{name}","href":"/en/api-reference/get-v1-evidence-timestamp-name"}]}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/en/mcp/connect"}]},{"tab":"Products","pages":[{"title":"Products","href":"/en/products/investigation"}]},{"tab":"Methodology and evidence","pages":[{"title":"Methodology and evidence","href":"/en/methodology/sealing"}]}]}]},"basePath":"","title":"Contribute a private label - 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"]}