curl --request POST \ --url https://api.blockworks.com/feedback \ --header 'Content-Type: application/json' \ --header 'X-Blockworks-API-Key: <api-key>' \ --data '{ "category": "data_quality", "message": "asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Retried with a wider window and got the same result. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.", "endpoint": "GET /query/timeseries/asset-marketcap/1d", "request": "GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin&start=2026-10-18&end=2026-10-18", "agent": "my-research-agent/1.4"}'
import requests
url = "https://api.blockworks.com/feedback"
payload = {
"category": "data_quality",
"message": "asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Retried with a wider window and got the same result. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.",
"endpoint": "GET /query/timeseries/asset-marketcap/1d",
"request": "GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin&start=2026-10-18&end=2026-10-18",
"agent": "my-research-agent/1.4"
}
headers = {
"X-Blockworks-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {'X-Blockworks-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
category: 'data_quality',
message: 'asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Retried with a wider window and got the same result. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.',
endpoint: 'GET /query/timeseries/asset-marketcap/1d',
request: 'GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin&start=2026-10-18&end=2026-10-18',
agent: 'my-research-agent/1.4'
})
};
fetch('https://api.blockworks.com/feedback', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.blockworks.com/feedback",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'category' => 'data_quality',
'message' => 'asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Retried with a wider window and got the same result. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.',
'endpoint' => 'GET /query/timeseries/asset-marketcap/1d',
'request' => 'GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin&start=2026-10-18&end=2026-10-18',
'agent' => 'my-research-agent/1.4'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Blockworks-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.blockworks.com/feedback"
payload := strings.NewReader("{\n \"category\": \"data_quality\",\n \"message\": \"asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Retried with a wider window and got the same result. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.\",\n \"endpoint\": \"GET /query/timeseries/asset-marketcap/1d\",\n \"request\": \"GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin&start=2026-10-18&end=2026-10-18\",\n \"agent\": \"my-research-agent/1.4\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Blockworks-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
HttpResponse<String> response = Unirest.post("https://api.blockworks.com/feedback")
.header("X-Blockworks-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"category\": \"data_quality\",\n \"message\": \"asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Retried with a wider window and got the same result. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.\",\n \"endpoint\": \"GET /query/timeseries/asset-marketcap/1d\",\n \"request\": \"GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin&start=2026-10-18&end=2026-10-18\",\n \"agent\": \"my-research-agent/1.4\"\n}")
.asString();
require 'uri'
require 'net/http'
url = URI("https://api.blockworks.com/feedback")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Blockworks-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"category\": \"data_quality\",\n \"message\": \"asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Retried with a wider window and got the same result. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.\",\n \"endpoint\": \"GET /query/timeseries/asset-marketcap/1d\",\n \"request\": \"GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin&start=2026-10-18&end=2026-10-18\",\n \"agent\": \"my-research-agent/1.4\"\n}"
response = http.request(request)
puts response.read_body
{
"error": "invalid field \"category\": category must be one of bug, data_quality, feature_request",
"data": null
}
{
"error": "Forbidden",
"data": null
}
{
"error": "<string>",
"data": "<unknown>"
}
{
"error": "<string>",
"data": "<unknown>"
}
Feedback
Submit Feedback
Report a bug or gap you hit while using Blockworks data: an error, an empty or surprising result, missing data, unclear docs, or a workaround you had to invent.
POST
/
feedback
Submit Feedback
curl --request POST \ --url https://api.blockworks.com/feedback \ --header 'Content-Type: application/json' \ --header 'X-Blockworks-API-Key: <api-key>' \ --data '{ "category": "data_quality", "message": "asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Retried with a wider window and got the same result. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.", "endpoint": "GET /query/timeseries/asset-marketcap/1d", "request": "GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin&start=2026-10-18&end=2026-10-18", "agent": "my-research-agent/1.4"}'
import requests
url = "https://api.blockworks.com/feedback"
payload = {
"category": "data_quality",
"message": "asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Retried with a wider window and got the same result. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.",
"endpoint": "GET /query/timeseries/asset-marketcap/1d",
"request": "GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin&start=2026-10-18&end=2026-10-18",
"agent": "my-research-agent/1.4"
}
headers = {
"X-Blockworks-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {'X-Blockworks-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
category: 'data_quality',
message: 'asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Retried with a wider window and got the same result. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.',
endpoint: 'GET /query/timeseries/asset-marketcap/1d',
request: 'GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin&start=2026-10-18&end=2026-10-18',
agent: 'my-research-agent/1.4'
})
};
fetch('https://api.blockworks.com/feedback', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.blockworks.com/feedback",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'category' => 'data_quality',
'message' => 'asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Retried with a wider window and got the same result. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.',
'endpoint' => 'GET /query/timeseries/asset-marketcap/1d',
'request' => 'GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin&start=2026-10-18&end=2026-10-18',
'agent' => 'my-research-agent/1.4'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Blockworks-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.blockworks.com/feedback"
payload := strings.NewReader("{\n \"category\": \"data_quality\",\n \"message\": \"asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Retried with a wider window and got the same result. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.\",\n \"endpoint\": \"GET /query/timeseries/asset-marketcap/1d\",\n \"request\": \"GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin&start=2026-10-18&end=2026-10-18\",\n \"agent\": \"my-research-agent/1.4\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Blockworks-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
HttpResponse<String> response = Unirest.post("https://api.blockworks.com/feedback")
.header("X-Blockworks-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"category\": \"data_quality\",\n \"message\": \"asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Retried with a wider window and got the same result. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.\",\n \"endpoint\": \"GET /query/timeseries/asset-marketcap/1d\",\n \"request\": \"GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin&start=2026-10-18&end=2026-10-18\",\n \"agent\": \"my-research-agent/1.4\"\n}")
.asString();
require 'uri'
require 'net/http'
url = URI("https://api.blockworks.com/feedback")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Blockworks-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"category\": \"data_quality\",\n \"message\": \"asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Retried with a wider window and got the same result. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.\",\n \"endpoint\": \"GET /query/timeseries/asset-marketcap/1d\",\n \"request\": \"GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin&start=2026-10-18&end=2026-10-18\",\n \"agent\": \"my-research-agent/1.4\"\n}"
response = http.request(request)
puts response.read_body
{
"error": "invalid field \"category\": category must be one of bug, data_quality, feature_request",
"data": null
}
{
"error": "Forbidden",
"data": null
}
{
"error": "<string>",
"data": "<unknown>"
}
{
"error": "<string>",
"data": "<unknown>"
}
Send one request per distinct issue, after you have resolved it or given up, so the report can say what you tried
and any workaround that worked. Agents connected to the MCP server send the same report with the
submit_feedback tool; both land in the same place.A useful report carries:
The exact request. The URL with its query string, or the tool arguments, in request.
What you expected and what came back instead, in message.
Request IDs. Data API and Monitoring responses carry an X-Request-ID header, and MCP tool errors from the
API include (request ID ...). Quote the IDs of the responses involved; they are how Blockworks finds the request
in its logs.
Submissions are stored by Blockworks and attributed to the account behind your API key, so leave out personal or
sensitive data. They are free and do not count against usage. Each user can send up to 60 an hour.
curl -X POST 'https://api.blockworks.com/feedback' \ --header "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY" \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: 3f1c2a9e-report-1' \ --data '{ "category": "data_quality", "message": "asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.", "endpoint": "GET /query/timeseries/asset-marketcap/1d", "request": "GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin&start=2026-10-18&end=2026-10-18" }'
If a request times out or returns 503, resend it with the same Idempotency-Key. Copies that share a key count
as one submission.
Authorizations
X-Blockworks-API-Key
string
header
required
Headers
Idempotency-Key
string
A value you choose, up to 128 characters, that ties retries of one submission together. Send the same key when you resend after a timeout or a 503, and the copies count as one submission.
Maximum string length: 128
Body
application/json
category
enum<string>
required
bug: something failed or returned wrong results. data_quality: data that is missing, stale, or wrong. feature_request: data or a capability you needed and could not find. Case does not matter.
Available options:
bug,
data_quality,
feature_request
message
string
required
What happened, what you expected, what you tried, and any workaround that worked. Include the request IDs of the responses involved: the X-Request-ID header on Data API and Monitoring responses. Up to 4,000 characters; longer text is cut.
Maximum string length: 4000
tool
string
The MCP tool the report is about, if any, such as tabular_data. Up to 128 characters.
Maximum string length: 128
endpoint
string
The API endpoint the report is about, if any, such as GET /query/tabular/assets. Up to 512 characters.
Maximum string length: 512
request
string
The exact request you made: the URL, or the tool arguments as JSON. Up to 2 KB; longer text is cut.
Maximum string length: 2048
agent
string
The agent or client sending the report, such as Claude Code or your own agent's name and version. Up to 128 characters.
Maximum string length: 128
Response
The submission was stored.
error
string | null
required
Always null on success.
data
object
required
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Blockworks Documentation","description":"The Blockworks Platform for onchain data, market intelligence, and research-grade metrics.","colors":{"primary":"#6633FF","light":"#9F9AFF","dark":"#5A2FDC"},"logo":{"light":"https://mintcdn.com/blockworksdocs/9frX9zdxv8EAKhzy/logo/blockworks-light.svg?fit=max\u0026auto=format\u0026n=9frX9zdxv8EAKhzy\u0026q=85\u0026s=0baa3020cfaa4a99f31f297664869273","dark":"https://mintcdn.com/blockworksdocs/9frX9zdxv8EAKhzy/logo/blockworks-dark.svg?fit=max\u0026auto=format\u0026n=9frX9zdxv8EAKhzy\u0026q=85\u0026s=b5f853bd4414515b561261d1a39ed740"},"favicon":{"light":"https://mintcdn.com/blockworksdocs/vDpnGk-ikoW5GBXD/logo/favicon-light.svg?fit=max\u0026auto=format\u0026n=vDpnGk-ikoW5GBXD\u0026q=85\u0026s=375413084b6db7faff0522e8de08bec9","dark":"https://mintcdn.com/blockworksdocs/vDpnGk-ikoW5GBXD/logo/favicon-dark.svg?fit=max\u0026auto=format\u0026n=vDpnGk-ikoW5GBXD\u0026q=85\u0026s=e9b5406e6549b9fb175f1904f2a86c36"},"background":{"color":{"light":"#FDFDFC","dark":"#1A1A1A"}},"navbar":{"links":[{"icon":"external-link","href":"https://app.blockworks.com/account/api","label":"Get API Key"}],"primary":{"type":"button","label":"Explore Intel","href":"https://app.blockworks.com"}},"footer":{"socials":{"x":"https://x.com/blockworks","github":"https://github.com/blockworks-projects","linkedin":"https://www.linkedin.com/company/blockworks"}},"fonts":{"heading":{"family":"Inter"},"body":{"family":"Inter"}},"icons":{"library":"tabler"},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"blockworksdocs","hasAudioNarration":false,"actualSubdomain":"blockworksdocs","customDomains":["docs.blockworks.com"],"gitSource":{"type":"github","owner":"blockworks-projects","repo":"blockworks-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af75947d022cd0f14d6664c","clientVersion":"0.0.4160","searchFilterCounts":[{"language":"default","tag":"Data API","count":375},{"language":"default","tag":"Onchain Fundamentals","count":252},{"language":"default","tag":"Assets","count":98},{"language":"default","tag":"Credit","count":51},{"language":"default","tag":"Asset Management","count":39},{"language":"default","tag":"Projects","count":38},{"language":"default","tag":"Market Data","count":37},{"language":"default","tag":"Lending Protocols","count":27},{"language":"default","tag":"Monitoring","count":22},{"language":"default","tag":"Social \u0026 Mindshare","count":21}]},"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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Fragment Mono';\n font-style: italic;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/fragmentmono/v6/4iC16K5wfMRRjxp0DA6-2CLnB4Z3ia0M31U.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Fragment Mono';\n font-style: italic;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/fragmentmono/v6/4iC16K5wfMRRjxp0DA6-2CLnB4Z3iq0M31U.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Fragment Mono';\n font-style: italic;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/fragmentmono/v6/4iC16K5wfMRRjxp0DA6-2CLnB4Z3hK0M.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Fragment Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/fragmentmono/v6/4iCr6K5wfMRRjxp0DA6-2CLnB45HhrUI.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Fragment Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/fragmentmono/v6/4iCr6K5wfMRRjxp0DA6-2CLnB41HhrUI.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Fragment Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/fragmentmono/v6/4iCr6K5wfMRRjxp0DA6-2CLnB4NHhg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--bw-mono: \"Fragment Mono\", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;--font-paper-mono: var(--bw-mono);--bw-salt-25: #fdfdfc;--bw-salt-100: #f4f4f4;--bw-salt-200: #eaeaea;--bw-salt-300: #e2e2e2;--bw-salt-500: #bfbfbf;--bw-salt-700: #767676;--bw-obsidian-500: #1a1a1a;--bw-obsidian-400: #2d2d2d;--bw-raised: var(--bw-salt-25);--bw-hairline: var(--bw-salt-300);--bw-rule: var(--bw-salt-500);--bw-faint: var(--bw-salt-700);--bw-lift: 0 1px 2px rgba(26, 26, 26, 0.05), 0 3px 10px rgba(26, 26, 26, 0.04);--bw-info-tint: rgba(102, 51, 255, 0.07);--bw-info-line: rgba(102, 51, 255, 0.32);--bw-info-text: #4f2bba;--bw-success: #1f8a5b;--bw-success-tint: rgba(31, 138, 91, 0.08);--bw-success-line: rgba(31, 138, 91, 0.32);--bw-success-text: #166e49;--bw-warning: #b5840f;--bw-warning-tint: rgba(181, 132, 15, 0.1);--bw-warning-line: rgba(181, 132, 15, 0.34);--bw-warning-text: #8a6400;--bw-error: #c0392b;--bw-error-tint: rgba(192, 57, 43, 0.07);--bw-error-line: rgba(192, 57, 43, 0.3);--bw-error-text: #9e2d22;--bw-radius-sm: 4px;--bw-radius: 6px;--bw-radius-lg: 8px}.dark{--bw-raised: var(--bw-obsidian-500);--bw-hairline: rgba(255, 255, 255, 0.13);--bw-rule: #494949;--bw-faint: #888888;--bw-lift: none;--bw-info-tint: rgba(102, 51, 255, 0.16);--bw-info-line: rgba(123, 99, 255, 0.55);--bw-info-text: #9f9aff;--bw-success-tint: rgba(31, 138, 91, 0.18);--bw-success-line: rgba(95, 191, 138, 0.5);--bw-success-text: #5fbf8a;--bw-warning-tint: rgba(181, 132, 15, 0.2);--bw-warning-line: rgba(217, 174, 84, 0.5);--bw-warning-text: #d9ae54;--bw-error-tint: rgba(192, 57, 43, 0.18);--bw-error-line: rgba(224, 122, 110, 0.5);--bw-error-text: #e07a6e}code,kbd,pre,samp,.font-mono,.shiki,.shiki span{font-family:var(--bw-mono)!important}h1#page-title{letter-spacing:-0.02em;font-weight:600}.card,.code-group,.callout,.accordion,[class*=\"rounded-2xl\"]{border-radius:var(--bw-radius-lg)!important}.card,.code-group{background-color:var(--bw-raised)!important;border-color:var(--bw-hairline)!important;box-shadow:var(--bw-lift)}.card:hover{border-color:rgb(var(--primary))!important}.dark .card:hover{border-color:rgb(var(--primary-light))!important}#sidebar-content a,.tryit-button,#topbar-cta-button a,button[class*=\"rounded-xl\"],[class*=\"rounded-xl\"]{border-radius:var(--bw-radius)!important}code:not(pre code),[class*=\"rounded-md\"]{border-radius:var(--bw-radius-sm)!important}.prose table th,.prose table td{border-bottom:1px solid var(--bw-hairline)}.callout{border-width:1px}.callout[class*=\"border-blue\"],.callout[class*=\"border-sky\"]{background-color:var(--bw-info-tint)!important;border-color:var(--bw-info-line)!important}.callout[class*=\"border-blue\"]>div:first-child,.callout[class*=\"border-sky\"]>div:first-child{color:var(--bw-info-text)!important}.callout[class*=\"border-green\"],.callout[class*=\"border-emerald\"]{background-color:var(--bw-success-tint)!important;border-color:var(--bw-success-line)!important}.callout[class*=\"border-green\"]>div:first-child,.callout[class*=\"border-emerald\"]>div:first-child{color:var(--bw-success-text)!important}.callout[class*=\"border-amber\"],.callout[class*=\"border-orange\"],.callout[class*=\"border-yellow\"]{background-color:var(--bw-warning-tint)!important;border-color:var(--bw-warning-line)!important}.callout[class*=\"border-amber\"]>div:first-child,.callout[class*=\"border-orange\"]>div:first-child,.callout[class*=\"border-yellow\"]>div:first-child{color:var(--bw-warning-text)!important}.callout[class*=\"border-red\"],.callout[class*=\"border-rose\"]{background-color:var(--bw-error-tint)!important;border-color:var(--bw-error-line)!important}.callout[class*=\"border-red\"]>div:first-child,.callout[class*=\"border-rose\"]>div:first-child{color:var(--bw-error-text)!important}.method-nav-pill span,[class*=\"method-pill\"],span[class*=\"bg-[#2AB673]\"]{border-radius:3px!important}.method-nav-pill span[class*=\"green\"],span[class*=\"bg-[#2AB673]\"],.tryit-button[class*=\"bg-[#2AB673]\"]{background-color:var(--bw-success)!important;color:#ffffff!important}span[class*=\"text-red-600\"][class*=\"rounded-md\"],span[class*=\"text-red-300\"][class*=\"rounded-md\"]{background-color:var(--bw-error-tint)!important;color:var(--bw-error-text)!important}.card .surface-tag{display:block;width:fit-content;margin-bottom:0.625rem;padding:0.125rem 0.5rem;border:1px solid var(--bw-info-line);border-radius:var(--bw-radius-sm);background-color:var(--bw-info-tint);color:var(--bw-info-text);font-size:0.6875rem;font-weight:600;letter-spacing:0.06em;text-transform:uppercase;line-height:1.3}.frame{background-color:var(--bw-raised)!important;border:1px solid var(--bw-hairline);box-shadow:var(--bw-lift)}"}],"page":{"pagePath":"api-reference/feedback/submit","slug":"/api-reference/feedback/submit","pageMetadata":{"title":"Submit Feedback","description":"Report a bug or gap you hit while using Blockworks data: an error, an empty or surprising result, missing data, unclear docs, or a workaround you had to invent.","openapi":"api-reference/feedback/openapi.json POST /feedback","href":"/api-reference/feedback/submit"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Report a bug or gap you hit while using Blockworks data: an error, an empty or surprising result, missing data, unclear docs, or a workaround you had to invent.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Note}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Send one request per distinct issue, after you have resolved it or given up, so the report can say what you tried\nand any workaround that worked. Agents connected to the `,_jsx(_components.a,{href:`/mcp/overview`,children:`MCP server`}),` send the same report with the\n`,_jsx(_components.a,{href:`/mcp/tools/feedback`,children:_jsx(_components.code,{children:`submit_feedback`})}),` tool; both land in the same place.`]}),`\n`,_jsx(_components.p,{children:`A useful report carries:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The exact request.`}),` The URL with its query string, or the tool arguments, in `,_jsx(_components.code,{children:`request`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`What you expected`}),` and what came back instead, in `,_jsx(_components.code,{children:`message`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Request IDs.`}),` Data API and Monitoring responses carry an `,_jsx(_components.code,{children:`X-Request-ID`}),` header, and MCP tool errors from the\nAPI include `,_jsx(_components.code,{children:`(request ID ...)`}),`. Quote the IDs of the responses involved; they are how Blockworks finds the request\nin its logs.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Submissions are stored by Blockworks and attributed to the account behind your API key, so leave out personal or\nsensitive data. They are free and do not count against usage. Each user can send up to 60 an hour.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.blockworks.com/feedback'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Blockworks-API-Key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$BLOCKWORKS_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Idempotency-Key: 3f1c2a9e-report-1'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"category\": \"data_quality\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"message\": \"asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"endpoint\": \"GET /query/timeseries/asset-marketcap/1d\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"request\": \"GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin\u0026start=2026-10-18\u0026end=2026-10-18\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`If a request times out or returns `,_jsx(_components.code,{children:`503`}),`, resend it with the same `,_jsx(_components.code,{children:`Idempotency-Key`}),`. Copies that share a key count\nas one submission.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Submit Feedback","description":"Report a bug or gap you hit while using Blockworks data: an error, an empty or surprising result, missing data, unclear docs, or a workaround you had to invent.","openapi":"api-reference/feedback/openapi.json POST /feedback","href":"/api-reference/feedback/submit"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/blockworksdocs/340d3b97b45994ec/eyebrow.js"],"openApiReferenceData":{"operation":{"operationId":"submitFeedback","tags":["Feedback"],"summary":"Submit Feedback","description":"Report a bug or gap you hit while using Blockworks data: an error, an empty or surprising result, missing data, unclear docs, or a workaround you had to invent.","parameters":["f1e52e4c-15f7-4af5-90c1-0f121325014a"],"requestBody":"d954e9fd-5dcf-440a-b880-e11294021772","responses":{"202":"c9be83d3-d0bc-44bd-99a3-0530702a2e76","400":"0089322a-ab70-4776-b0ce-62d7f9b3db07","403":"6ac63a21-ebea-4145-8d80-3761f93cfbec","429":"d86ce3fb-5856-4e3e-a528-6149bfd82f23","503":"ee6b55ce-5266-415b-8cb1-0bc22de22f37"},"method":"post","type":"path","servers":["5aecd38c-d4a0-4337-981d-3a5f8cc92ec3"],"security":["7753d29f-26af-48d9-b430-045556ac6c7c"],"path":"/https/docs.blockworks.com/feedback","baseUrlOptions":["https://api.blockworks.com"],"title":"Submit Feedback","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f1e52e4c-15f7-4af5-90c1-0f121325014a":{"name":"Idempotency-Key","in":"header","required":false,"description":"A value you choose, up to 128 characters, that ties retries of one submission together. Send the same key when you resend after a timeout or a 503, and the copies count as one submission.","schema":{"type":"string","maxLength":128,"isRequired":false,"description":"A value you choose, up to 128 characters, that ties retries of one submission together. Send the same key when you resend after a timeout or a 503, and the copies count as one submission.","uniqueKey":"","typeLabel":"string"},"example":"3f1c2a9e-report-1"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["category","message"],"properties":{"category":{"type":"string","enum":["bug","data_quality","feature_request"],"description":"`bug`: something failed or returned wrong results. `data_quality`: data that is missing, stale, or wrong. `feature_request`: data or a capability you needed and could not find. Case does not matter.","isRequired":true,"uniqueKey":"category","typeLabel":"enum\u003cstring>"},"message":{"type":"string","maxLength":4000,"description":"What happened, what you expected, what you tried, and any workaround that worked. Include the request IDs of the responses involved: the X-Request-ID header on Data API and Monitoring responses. Up to 4,000 characters; longer text is cut.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"tool":{"type":"string","description":"The MCP tool the report is about, if any, such as `tabular_data`. Up to 128 characters.","maxLength":128,"uniqueKey":"tool","typeLabel":"string"},"endpoint":{"type":"string","description":"The API endpoint the report is about, if any, such as `GET /query/tabular/assets`. Up to 512 characters.","maxLength":512,"uniqueKey":"endpoint","typeLabel":"string"},"request":{"type":"string","maxLength":2048,"description":"The exact request you made: the URL, or the tool arguments as JSON. Up to 2 KB; longer text is cut.","uniqueKey":"request","typeLabel":"string"},"agent":{"type":"string","description":"The agent or client sending the report, such as `Claude Code` or your own agent's name and version. Up to 128 characters.","maxLength":128,"uniqueKey":"agent","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"category":"data_quality","message":"asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Retried with a wider window and got the same result. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.","endpoint":"GET /query/timeseries/asset-marketcap/1d","request":"GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin\u0026start=2026-10-18\u0026end=2026-10-18","agent":"my-research-agent/1.4"},"examples":{"Example":{"title":"Example","value":{"category":"data_quality","message":"asset-marketcap returned no rows for bitcoin on 2026-10-18. Expected one row per day. Retried with a wider window and got the same result. Request ID 6047f3ac-edd5-4a29-adbb-f451dc1afe2d.","endpoint":"GET /query/timeseries/asset-marketcap/1d","request":"GET https://api.blockworks.com/query/timeseries/asset-marketcap/1d?series=bitcoin\u0026start=2026-10-18\u0026end=2026-10-18","agent":"my-research-agent/1.4"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"c9be83d3-d0bc-44bd-99a3-0530702a2e76":{"description":"The submission was stored.","content":{"application/json":{"schema":{"type":"object","required":["error","data"],"properties":{"error":{"oneOf":[{"type":"string","description":"Always null on success.","isRequired":true,"uniqueKey":"error.oneOf.0","typeLabel":"string"},{"type":"null","description":"Always null on success.","isRequired":true,"uniqueKey":"error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error","typeLabel":"string | null"},"data":{"type":"object","required":["feedback_id","truncated"],"properties":{"feedback_id":{"type":"string","description":"The submission's ID. Quote it if you follow up.","isRequired":true,"uniqueKey":"data.feedback_id","typeLabel":"string"},"truncated":{"type":"boolean","description":"True when any field was longer than its limit and was cut.","isRequired":true,"uniqueKey":"data.truncated","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":null,"data":{"feedback_id":"0eb1efd4-303f-44a8-8130-70ae828bc077","truncated":false}},"examples":{"Example":{"title":"Example","value":{"error":null,"data":{"feedback_id":"0eb1efd4-303f-44a8-8130-70ae828bc077","truncated":false}}}},"exampleType":"examples"}},"exampleType":"examples"},"0089322a-ab70-4776-b0ce-62d7f9b3db07":{"description":"A required field is missing or a value is not allowed. The error names the field.","content":{"application/json":{"schema":{"type":"object","required":["error","data"],"properties":{"error":{"type":"string","description":"What went wrong.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"data":{"oneOf":[{"description":"Always null on error.","isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"any"},{"description":"Always null on error.","type":"null","isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data","typeLabel":"any | null"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"invalid field \"category\": category must be one of bug, data_quality, feature_request","data":null},"examples":{"Example":{"title":"Example","value":{"error":"invalid field \"category\": category must be one of bug, data_quality, feature_request","data":null}}},"exampleType":"examples"}},"exampleType":"examples"},"6ac63a21-ebea-4145-8d80-3761f93cfbec":{"description":"The API key is missing or not valid.","content":{"application/json":{"schema":{"type":"object","required":["error","data"],"properties":{"error":{"type":"string","description":"What went wrong.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"data":{"oneOf":[{"description":"Always null on error.","isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"any"},{"description":"Always null on error.","type":"null","isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data","typeLabel":"any | null"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Forbidden","data":null},"examples":{"Example":{"title":"Example","value":{"error":"Forbidden","data":null}}},"exampleType":"examples"}},"exampleType":"examples"},"d86ce3fb-5856-4e3e-a528-6149bfd82f23":{"description":"This user has sent 60 submissions in the last hour. The Retry-After header gives the seconds to wait.","headers":{"Retry-After":{"description":"Seconds to wait before sending again.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["error","data"],"properties":{"error":{"type":"string","description":"What went wrong.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"data":{"oneOf":[{"description":"Always null on error.","isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"any"},{"description":"Always null on error.","type":"null","isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data","typeLabel":"any | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","data":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"},"ee6b55ce-5266-415b-8cb1-0bc22de22f37":{"description":"The submission was not stored. Retry after a short wait with the same Idempotency-Key.","content":{"application/json":{"schema":{"type":"object","required":["error","data"],"properties":{"error":{"type":"string","description":"What went wrong.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"data":{"oneOf":[{"description":"Always null on error.","isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"any"},{"description":"Always null on error.","type":"null","isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data","typeLabel":"any | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","data":"\u003cunknown>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"7753d29f-26af-48d9-b430-045556ac6c7c":{"apiKey":{"type":"apiKey","in":"header","name":"X-Blockworks-API-Key","scopes":[],"schemeName":"apiKey"}}},"servers":{"5aecd38c-d4a0-4337-981d-3a5f8cc92ec3":{"url":"https://api.blockworks.com","description":"Blockworks API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Blockworks-API-Key","scopes":[],"schemeName":"apiKey"},"schema":{"title":"X-Blockworks-API-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"X-Blockworks-API-Key"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/feedback/openapi.json"},"subdomain":"blockworksdocs","siteName":"Blockworks Documentation","title":"Submit Feedback - Blockworks Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-20T20:55:16.769Z","originalFileLocation":"api-reference/feedback/submit.mdx"},"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=\"system\"}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=\"Report a bug or gap you hit while using Blockworks data: an error, an empty or surprising result, missing data, unclear docs, or a workaround you had to invent.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Blockworks Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/blockworksdocs/FWEi4bUbLJO5T8pF/_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/blockworksdocs/FWEi4bUbLJO5T8pF/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/blockworksdocs/FWEi4bUbLJO5T8pF/_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/blockworksdocs/FWEi4bUbLJO5T8pF/_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/blockworksdocs/FWEi4bUbLJO5T8pF/_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/blockworksdocs/FWEi4bUbLJO5T8pF/_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/blockworksdocs/FWEi4bUbLJO5T8pF/_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/blockworksdocs/FWEi4bUbLJO5T8pF/_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/blockworksdocs/FWEi4bUbLJO5T8pF/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Submit Feedback - Blockworks Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Report a bug or gap you hit while using Blockworks data: an error, an empty or surprising result, missing data, unclear docs, or a workaround you had to invent.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Blockworks Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.blockworks.com/api-reference/feedback/submit\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://blockworksdocs.mintlify.site/_mintlify/api/og/v2?division=Feedback\u0026amp;title=Submit+Feedback\u0026amp;description=Report+a+bug+or+gap+you+hit+while+using+Blockworks+data%3A+an+error%2C+an+empty+or+surprising+result%2C+missing+data%2C+unclear+docs%2C+or+a+workaround+you+had+to+invent.\u0026amp;theme=1c7eb4aea9d8dca70d80b2c7\u0026amp;signature=67692cb5396b17e0e50183d3248a047910f2d7c6125293a6fc24e6bd613b4abf\">\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=\"Submit Feedback - Blockworks Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Report a bug or gap you hit while using Blockworks data: an error, an empty or surprising result, missing data, unclear docs, or a workaround you had to invent.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://blockworksdocs.mintlify.site/_mintlify/api/og/v2?division=Feedback\u0026amp;title=Submit+Feedback\u0026amp;description=Report+a+bug+or+gap+you+hit+while+using+Blockworks+data%3A+an+error%2C+an+empty+or+surprising+result%2C+missing+data%2C+unclear+docs%2C+or+a+workaround+you+had+to+invent.\u0026amp;theme=1c7eb4aea9d8dca70d80b2c7\u0026amp;signature=67692cb5396b17e0e50183d3248a047910f2d7c6125293a6fc24e6bd613b4abf\">\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/blockworksdocs/FWEi4bUbLJO5T8pF/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Blockworks Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6633FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.blockworks.com/api-reference/feedback/submit\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/feedback/submit.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.blockworks.com/#organization\",\"name\":\"Blockworks Documentation\",\"url\":\"https://docs.blockworks.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/blockworksdocs/9frX9zdxv8EAKhzy/logo/blockworks-light.svg?fit=max\u0026auto=format\u0026n=9frX9zdxv8EAKhzy\u0026q=85\u0026s=0baa3020cfaa4a99f31f297664869273\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.blockworks.com#website\",\"name\":\"Blockworks Documentation\",\"url\":\"https://docs.blockworks.com\",\"publisher\":{\"@id\":\"https://docs.blockworks.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.blockworks.com/api-reference/feedback/submit#webpage\",\"url\":\"https://docs.blockworks.com/api-reference/feedback/submit\",\"name\":\"Submit Feedback\",\"description\":\"Report a bug or gap you hit while using Blockworks data: an error, an empty or surprising result, missing data, unclear docs, or a workaround you had to invent.\",\"dateModified\":\"2026-10-20T20:55:16.769Z\",\"isPartOf\":{\"@id\":\"https://docs.blockworks.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.blockworks.com/api-reference/feedback/submit#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.blockworks.com/api-reference/feedback/submit#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Blockworks Documentation\",\"item\":\"https://docs.blockworks.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Submit Feedback\",\"item\":\"https://docs.blockworks.com/api-reference/feedback/submit\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.blockworks.com/api-reference/feedback/submit#apireference\",\"headline\":\"Submit Feedback\",\"name\":\"Submit Feedback\",\"description\":\"Report a bug or gap you hit while using Blockworks data: an error, an empty or surprising result, missing data, unclear docs, or a workaround you had to invent.\",\"url\":\"https://docs.blockworks.com/api-reference/feedback/submit\",\"mainEntityOfPage\":{\"@id\":\"https://docs.blockworks.com/api-reference/feedback/submit#webpage\"},\"dateModified\":\"2026-10-20T20:55:16.769Z\",\"publisher\":{\"@id\":\"https://docs.blockworks.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.blockworks.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Blockworks Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Blockworks Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/feedback/submit.md","siteName":"Blockworks Documentation","nav":{"global":null,"tabs":[{"tab":"Welcome","groups":[{"group":"Welcome","pages":[{"title":"Blockworks Docs","href":"/introduction"},{"title":"Authentication","description":"Authenticate every Blockworks API request with an API key sent in the X-Blockworks-API-Key header.","href":"/getting-started/authentication"}]},{"group":"Feedback","pages":[{"title":"Submit Feedback","openapi":"api-reference/feedback/openapi.json POST /feedback","href":"/api-reference/feedback/submit"}]}]},{"tab":"Data API","pages":[{"title":"Data API","href":"/getting-started/data-api"}]},{"tab":"Monitoring","pages":[{"title":"Monitoring","href":"/api-reference/monitoring/overview"}]},{"tab":"MCP Server","pages":[{"title":"MCP Server","href":"/mcp/overview"}]},{"tab":"Datashares","pages":[{"title":"Datashares","href":"/datashare/overview"}]},{"tab":"Plugins","pages":[{"title":"Plugins","href":"/spreadsheets/overview"}]}]},"basePath":"","title":"Submit Feedback - Blockworks Documentation","buildId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","deploymentId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BFmjTMeT.js","utils-BWr-sjpP.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-LafIDf0N.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-MJNzuxek.js","snippetPresets-DPZEtUvW.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DQ2UhGIs.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DUUJTUkE.js","shallow-BTf5bw35.js","getApiPlaygroundDisplay-h2POYYOO.js","CodeSnippet-C4qEftRe.js","CodeSnippets-CsSrOqMC.js","Page-CWFqNdGh.js","getPastedJson-DU6W6y78.js","icon-2ZYNQ78y.js","MethodPill-BMXJzYMm.js","DuplicateIcon-DNjdEpYZ.js","createIcon-WdPVhKxl.js","DynamicMarkdown-Z_y464fM.js","SectionHeading-Bcrd8azU.js","axios-vUo_bRtp.js","Markdown-BnvucbFu.js","dist-D7YyC486.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-D1I8TPjt.js"]}