Skip to content
Gib docs
Search
Ctrl
K
Cancel
GitHub
Auto
Light
Dark
Menu
Getting started
What Gib is
First requests
API guide
API reference overview
Images
Image options
Image priority
Token lists
Search
Networks
Statistics
Sprite sheets
Submissions
Service endpoints
Caching
Rate limits
Integration examples
List management
List management overview
Creating lists
Token list format
Image management
Loading metadata from a chain
Publishing
Token discovery
Local storage
Self-hosting
Self-hosting overview
Configuration
Running the server
Domains and reverse proxies
Collection
Etherscan collector
Image storage
Moving between stores
Image resizing
Contributing
Contributing overview
Development setup and tests
Architecture
Database and primary keys
Image store internals
Image serving
Collectors
Token lists and ordering
Token search
Front end
Continuous integration and TypeScript
Design
Design language
Storybook
Endpoint reference
Overview
Token Endpoints
Overview
All available token lists
All deduplicated tokens for a chain, ranked by list priority
Merged token list across providers for one chain, using a named ordering
Search tokens by name, symbol or address across every chain
A provider's default token list (listKey omitted)
A specific provider token list
A specific versioned token list
Image Endpoints
Overview
Network / chain icon
Token image, priority-ordered by list ranking
Token image converted to a specific format via path extension
Token image with an explicit provider ordering
Ordered image lookup that falls back to unordered
Image by content hash — content-addressed access
Batch lookup — first match across repeated i= candidates
Sprite sheet manifest (JSON) for a token list
Rendered sprite sheet image (WebP) — same parameters as the manifest
Stylesheet for a token list: one class per token, with its cell position
Networks & Stats
Overview
All supported networks with chain ids and icon hashes
Per-chain counts of token addresses that have a usable image
Submissions
Overview
Submit a token list URL for inclusion
List submissions, optionally filtered by status
Approved submissions feed for the collector (admin token required)
Update a submission status / image mode (admin token required)
Submit a token image as a base64 data URI (max 512KB)
Service
Overview
Readiness probe — 200 once migrations and cache warmup finish, 503 while starting
This OpenAPI 3.1 definition — the source the docs page renders from
A machine-readable index of the public API and guides, per the llmstxt.org convention
Terms and attribution — the licence/attribution page every image response links back to
A hand-written guide (api-reference.md, list-management.md, self-hosting.md)
Redirects to the hash-routed documentation page in the interface
Redirects to the hash-routed token list studio in the interface
GitHub OAuth code-for-token exchange proxy (used by the studio publish flow)
GitHub
Auto
Light
Dark
Overview
Token Endpoints
Section titled “Token Endpoints”
Token lists, ranked per-chain tokens, and list discovery.
Operations
Section titled “Operations”
GET
/list/
GET
/list/tokens/{chainId}
GET
/list/merged/{order}
GET
/list/search
GET
/list/{providerKey}
GET
/list/{providerKey}/{listKey}
GET
/list/{providerKey}/{listKey}/{version}