{"uid":"cap_cvdHY0G_A7oWOM2KLICga","slug":"token-holder-observations-category-allowlist-check-ca5ea398","name":"Token Holder Observations — Category Allowlist Check","description":"Token holder observations — Category allowlist check: Category allowlist check for Token holder observations. Validate a declared CSV table contract, up to 1000 rows. Quoted cells supported; no external enrichment. Specialised preset in a shared 50-profile, 20-operation engine. 0.01 USDC includes one CSV category allowlist check report.","url":"https://market.datapackvibe.com/x402/assistant-bx-csv-token-holders-categories?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"csv":{"type":"string","default":"observation_id,observed_on,token_address,holder_count,circulating_tokens\nrecord-a,2026-01-01,group-a,10,2\nrecord-b,2026-01-02,group-b,20,3","maxLength":100000,"minLength":1},"maximum":{"type":"number","default":1000000000000,"maximum":1000000000000,"minimum":-1000000000000},"minimum":{"type":"number","default":-1000000000000,"maximum":1000000000000,"minimum":-1000000000000},"delimiter":{"enum":[",",";","\t"],"type":"string","default":","},"max_cell_length":{"type":"integer","default":1000,"maximum":5000,"minimum":1},"allowed_categories":{"type":"array","items":{"type":"string","default":"","maxLength":100,"minLength":1},"default":["group-a","group-b"],"maxItems":100,"minItems":0}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lE5WkTSdCqnQYvj8WOpz1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates a CSV table of token holder observations by checking that category values fall within a user-defined allowlist of permitted categories.","exampleAgentPrompt":"Can you validate my token holder observations CSV and check that all the category values are within my allowed list of [\"group-a\", \"group-b\", \"group-c\"]? The CSV uses comma delimiters and has up to 500 rows.","exampleUseCases":[{"title":"DeFi token holder audit","prompt":"I have a CSV of token holder observations and I need to make sure all the token_address categories are only from this approved list: [\"0xABC\", \"0xDEF\", \"0x123\"]. Can you run a category allowlist check on it for me using comma as the delimiter?"},{"title":"Compliance check before reporting","prompt":"Before I submit this token holder observation report, please validate that every category column entry in my CSV is one of these permitted values: [\"tier-1\", \"tier-2\", \"tier-3\"] — flag any rows that don't comply."},{"title":"Data pipeline category gate","prompt":"I'm ingesting token holder data automatically and need to verify the categories in this CSV match exactly [\"retail\", \"institutional\", \"protocol\"] before passing it downstream. Can you run the category allowlist check and tell me which rows fail?"}],"resultDescription":"A category allowlist check report indicating which rows in the token holder observations CSV contain category values outside the declared allowed list, along with a summary of compliant and non-compliant entries across up to 1000 rows.","failureModes":["CSV exceeds 1000 rows — only up to 1000 rows are validated","CSV string exceeds 100,000 character limit — request rejected","No allowed_categories provided — all categories may be flagged or no check performed","Invalid delimiter specified — parsing errors on non-comma/semicolon/tab input","Cell length exceeds max_cell_length — row may be rejected or truncated","Malformed CSV with unmatched quotes — parsing failure"],"whenToPreferThis":"Choose this endpoint when you have a structured CSV of token holder observations and need to enforce that category fields (such as token address groups) only contain values from a predefined allowlist. It is purpose-built for this specific validation pattern and includes support for quoted cells and configurable delimiters. Prefer it over general-purpose validators when working within the token holder observation data model.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T18:48:18.770Z","isFirstParty":false,"canonicalSlug":"token-holder-observations-category-allowlist-check-ca5ea398"}