Skip to content

Submit a token list URL for inclusion

POST
/api/lists/submit
curl --request POST \
--url https://gib.show/api/lists/submit \
--header 'Content-Type: application/json' \
--data '{ "url": "example", "name": "example", "submittedBy": "example", "description": "example" }'
Media type: application/json
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"
}

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).

Media type: application/json
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.

Media type: application/json
object
error
string

Example generated

{
"error": "example"
}