{"uid":"cap_zmVsyjZuzYs3Umz4bU2EO","slug":"token-holder-observations-csv-header-contract-check-64f96147","name":"Token Holder Observations — CSV Header Contract Check","description":"Token holder observations — Header contract check: Header contract 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 header contract check report.","url":"https://market.datapackvibe.com/x402/assistant-bx-csv-token-holders-schema?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_qZrPUac0lLmSvkAIEDC40","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 the CSV header contract (column names, types, and value constraints) for token holder observation data, supporting up to 1000 rows.","exampleAgentPrompt":"Can you check whether my token holder observations CSV has the right headers and valid data? It uses comma delimiters, holder counts between 0 and 1,000,000, and allowed category values of 'group-a' and 'group-b'.","exampleUseCases":[{"title":"Pre-upload token holder data check","prompt":"Before I push this token holder CSV to our pipeline, can you validate the headers and make sure holder_count and circulating_tokens are within 0 to 500000, delimiter is comma, and allowed categories are 'group-a' and 'group-b'?"},{"title":"Automated DeFi data quality gate","prompt":"Run a header contract check on this token holder observations CSV — comma-delimited, max cell length 200, values between -1000000000000 and 1000000000000, and categories limited to 'group-a', 'group-b', 'group-c' — and tell me if anything fails."},{"title":"Schema regression test for analytics pipeline","prompt":"I just updated our token holder snapshot format — can you validate the CSV header contract against the expected columns like observation_id, observed_on, token_address, holder_count, and circulating_tokens, using semicolon as the delimiter?"}],"resultDescription":"A header contract check report indicating whether the CSV's column headers and data values conform to the declared schema, including any violations in column names, value ranges, cell lengths, or category allowlists, covering up to 1000 rows.","failureModes":["CSV exceeds 100,000 character limit — request rejected","CSV has fewer than 1 character — validation fails","Delimiter not in allowed set (comma, semicolon, tab) — schema error","Allowed categories list exceeds 100 items — rejected","Cell length exceeds max_cell_length threshold — row-level violation reported","Malformed CSV with unclosed quotes — parser error","Numeric values outside declared minimum/maximum bounds — contract violation flagged"],"whenToPreferThis":"Use this endpoint when you need a lightweight, contract-focused validation of a token holder observations CSV — specifically checking headers, value ranges, cell lengths, and category allowlists — without any external enrichment or complex schema inference. It is purpose-built for the token holder observation data shape (observation_id, observed_on, token_address, holder_count, circulating_tokens) and ideal for pre-upload quality gates or regression checks in DeFi data pipelines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T00:56:04.310Z","isFirstParty":false,"canonicalSlug":"token-holder-observations-csv-header-contract-check-64f96147"}