Quickstart
Every endpoint is unauthenticated, read-only JSON over plain HTTP GET. This page covers the three things every integration needs before reading the endpoint reference.
Base URL
The hosted API lives at https://hive-apis.freebeings.io/he-nft — that's the base URL used in
every example below. Response shapes are pre-release drafts until v0.1.0 (see the
changelog). Self-hosting? Point the examples at your
own instance instead — see
he-nft-directory's README:
quickstart-curl.sh curl "https://hive-apis.freebeings.io/he-nft/collections?limit=10" The Try it console lets you point requests at any base URL, including a self-hosted deployment — this is an open-source, independently runnable project, not a single hosted service.
Response envelope
List endpoints return a top-level object keyed by resource name, plus a cursor field for the next page:
example-list-response.json {
"collections": [
{
"symbol": "MYNFT",
"name": "Example Collection",
"supply": 10000
}
],
"next_cursor_symbol": "MYNFT"
} Pagination
List endpoints are cursor-paginated: pass the previous response's next_cursor
(or next_cursor_symbol on /collections) back as
?cursor= / ?cursor_symbol=. A page shorter than the requested
?limit= (default 100, capped at 1000) means you've reached the end —
next_cursor comes back null. There is no total count; don't
build UI that assumes one.
Errors
- 400 a path or query parameter failed to parse
- 404 no resource matched the path
- 500 unhandled failure, never a stack trace
Every error body is { "error": "<status line>" }.