curl --request GET \
--url https://api.blockworks.com/query/tabular/token-transparency-filings \
--header 'X-Blockworks-API-Key: <api-key>'import requests
url = "https://api.blockworks.com/query/tabular/token-transparency-filings"
headers = {"X-Blockworks-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Blockworks-API-Key': '<api-key>'}};
fetch('https://api.blockworks.com/query/tabular/token-transparency-filings', 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/query/tabular/token-transparency-filings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.blockworks.com/query/tabular/token-transparency-filings"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Blockworks-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.blockworks.com/query/tabular/token-transparency-filings")
.header("X-Blockworks-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.blockworks.com/query/tabular/token-transparency-filings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Blockworks-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"bwProjectID": 123,
"bwProjectSlug": "<string>",
"completionLabel": "<string>",
"dateFiled": "2023-11-07T05:31:56Z",
"filingID": "<string>",
"filingStatus": "<string>",
"filingType": "<string>",
"filingTypeRank": 123,
"filingVersion": "<string>",
"gapCount": 123,
"isLatestForType": true,
"isSuperseded": true,
"projectID": "<string>",
"projectName": "<string>",
"projectSlug": "<string>",
"protocolName": "<string>",
"protocolTicker": "<string>",
"provenance": "<string>",
"publishAt": "2023-11-07T05:31:56Z",
"questionCount": 123,
"schemaID": "<string>",
"stalenessNextDeadline": "2023-11-07T05:31:56Z",
"stalenessTTLMonths": 123,
"staticURL": "<string>",
"submissionRound": 123
}
],
"metadata": {
"totalPages": 123,
"totalRows": 123
},
"error": "<string>"
}{
"data": null,
"error": "unknown query parameter \"filingID\""
}{
"data": null,
"error": "this model requires authentication"
}{
"data": null,
"error": "this model requires the \"token_transparency_framework_unified\" permission"
}{
"data": null,
"error": "tabular model \"unknown-model\" not found"
}List Token Transparency Filings
One row per published Token Transparency Framework filing, keyed by filingID: project, filing type and version, schema, publish and filing dates, provenance, question and gap counts with a completion label, latest and superseded flags, status and the filing’s page URL. Filter by project, ticker, type, status or date.
curl --request GET \
--url https://api.blockworks.com/query/tabular/token-transparency-filings \
--header 'X-Blockworks-API-Key: <api-key>'import requests
url = "https://api.blockworks.com/query/tabular/token-transparency-filings"
headers = {"X-Blockworks-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Blockworks-API-Key': '<api-key>'}};
fetch('https://api.blockworks.com/query/tabular/token-transparency-filings', 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/query/tabular/token-transparency-filings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.blockworks.com/query/tabular/token-transparency-filings"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Blockworks-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.blockworks.com/query/tabular/token-transparency-filings")
.header("X-Blockworks-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.blockworks.com/query/tabular/token-transparency-filings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Blockworks-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"bwProjectID": 123,
"bwProjectSlug": "<string>",
"completionLabel": "<string>",
"dateFiled": "2023-11-07T05:31:56Z",
"filingID": "<string>",
"filingStatus": "<string>",
"filingType": "<string>",
"filingTypeRank": 123,
"filingVersion": "<string>",
"gapCount": 123,
"isLatestForType": true,
"isSuperseded": true,
"projectID": "<string>",
"projectName": "<string>",
"projectSlug": "<string>",
"protocolName": "<string>",
"protocolTicker": "<string>",
"provenance": "<string>",
"publishAt": "2023-11-07T05:31:56Z",
"questionCount": 123,
"schemaID": "<string>",
"stalenessNextDeadline": "2023-11-07T05:31:56Z",
"stalenessTTLMonths": 123,
"staticURL": "<string>",
"submissionRound": 123
}
],
"metadata": {
"totalPages": 123,
"totalRows": 123
},
"error": "<string>"
}{
"data": null,
"error": "unknown query parameter \"filingID\""
}{
"data": null,
"error": "this model requires authentication"
}{
"data": null,
"error": "this model requires the \"token_transparency_framework_unified\" permission"
}{
"data": null,
"error": "tabular model \"unknown-model\" not found"
}Authorizations
API key sent in the X-Blockworks-API-Key header; x-messari-api-key is accepted for existing integrations. The catalog endpoints and models on the public access tier need no key.
Query Parameters
Filing ID equals.
Filing ID is one of (comma-separated).
Project ID equals.
Project ID is one of (comma-separated).
Project Slug equals.
Project Slug is one of (comma-separated).
Project Slug is not one of (comma-separated).
Protocol Name equals.
Protocol Name is one of (comma-separated).
Protocol Name contains (case-insensitive substring).
Protocol Ticker equals.
Protocol Ticker is one of (comma-separated).
Protocol Ticker is not one of (comma-separated).
Mapped Project ID equals.
Mapped Project ID is one of (comma-separated).
Mapped Project Slug equals.
Mapped Project Slug is one of (comma-separated).
Filing Type equals.
Filing Type is one of (comma-separated).
Filing Type is not one of (comma-separated).
Filing Version equals.
Filing Version is one of (comma-separated).
Schema ID equals.
Schema ID is one of (comma-separated).
Provenance equals.
Provenance is one of (comma-separated).
Publish Time is greater than.
Publish Time is greater than or equal to.
Publish Time is less than.
Publish Time is less than or equal to.
Date Filed equals.
Date Filed is greater than.
Date Filed is greater than or equal to.
Date Filed is less than.
Date Filed is less than or equal to.
Gap Count equals.
Gap Count is greater than.
Gap Count is greater than or equal to.
Gap Count is less than.
Gap Count is less than or equal to.
Completion Label equals.
Completion Label is one of (comma-separated).
Filing Type Rank equals.
Filing Type Rank is less than or equal to.
Is Superseded equals.
Is Latest For Type equals.
Filing Status equals.
Filing Status is one of (comma-separated).
Field to sort by; defaults to the model's default sort column.
bwProjectSlug, protocolName, filingType, publishAt, dateFiled, gapCount Sort direction.
asc, desc 1-based page number.
Rows per page (max 1000, default 100).
Comma-separated fields to return; defaults to all fields.
filingID, bwProjectID, bwProjectSlug, protocolName, protocolTicker, projectID, projectSlug, projectName, filingType, filingVersion, schemaID, submissionRound, provenance, publishAt, dateFiled, questionCount, gapCount, completionLabel, filingTypeRank, isSuperseded, isLatestForType, filingStatus, stalenessTTLMonths, stalenessNextDeadline, staticURL Response format, overriding the Accept header: json (default), csv, or jsonl (NDJSON). csv and jsonl return the rows as a downloadable file.
json, csv, jsonl