Submit a token list URL for inclusion
POST
/api/lists/submit
const url = 'https://gib.show/api/lists/submit';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"url":"example","name":"example","submittedBy":"example","description":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://gib.show/api/lists/submit \ --header 'Content-Type: application/json' \ --data '{ "url": "example", "name": "example", "submittedBy": "example", "description": "example" }'Request Bodyrequired
Section titled “Request Bodyrequired”object
url
required
URL serving a Uniswap-style token list JSON.
string
name
required
string
submittedBy
required
string
description
string
Example generated
{ "url": "example", "name": "example", "submittedBy": "example", "description": "example"}Responses
Section titled “Responses”Submission accepted (new submissions start pending). Resubmitting an existing URL updates name/description/submittedBy and returns the existing status (it is not reset to pending).
object
id
string
status
string
providerKey
string
listKey
string
Example generated
{ "id": "example", "status": "example", "providerKey": "example", "listKey": "example"}Missing fields, disallowed URL (non-http(s) or private address), or not a token list.
object
error
string
Example generated
{ "error": "example"}