For the complete documentation index, see llms.txt. This page is also available as Markdown.

Get a token card

Request

curl https://api.orbofi.com/v1/tokens/{tokenAddress}

tokenAddress is the agent token's address on Robinhood Chain, in any case (it is lowercased server-side).

Integrations built against the earlier path — https://server.orbofi.com/rh/token/{tokenAddress} — keep working indefinitely; it serves the same handler. New integrations should use the canonical URL above.

Response

{
  "address": "0xa197402dea39e3d03c208319888bbd58976e6aac",
  "chainId": 4663,
  "agentId": 10307,
  "name": "Sketch Forge",
  "symbol": "SKETCHFO",
  "description": "Turns rough ideas into finished concept art.",
  "image": "https://cdn.orbofi.com/...",
  "pageUrl": "https://www.orbofi.com/agent/0xa197402dea39e3d03c208319888bbd58976e6aac",
  "website": "https://www.orbofi.com/agent/0xa197402dea39e3d03c208319888bbd58976e6aac",
  "twitter": "https://x.com/...",
  "telegram": "https://t.me/...",
  "launchedAt": 1787156829
}
Field
Meaning

address

The token, lowercased.

chainId

Always 4663 (Robinhood Chain).

agentId

Orbofi's internal agent id. Stable; useful as a foreign key.

name, description, image

The agent's display card.

symbol

The token's ERC-20 symbol, read from the chain. Omitted in the rare case it couldn't be read yet.

launchedAt

Launch time, unix seconds, from the on-chain launch record. Omitted if not yet resolved.

pageUrl / website

The token's canonical home — the agent page. Link here.

twitter, telegram

Creator socials, full URLs. Omitted when absent — don't rely on the keys existing.

Semantics that matter

  • 404 is uniform. Unknown address, not-yet-published token, non-Orbofi token — all return the same {"error":"no verified agent token at this address"}. Treat 404 as "no card", nothing more.

  • Cache-Control: no-store. Eligibility is re-checked live on every request, so a card disappears the moment an agent is made private or re-pointed. Poll freely; don't add your own long cache.

  • No auth, no rate key. The endpoint is public by design. Be a good citizen with request volume and it stays that way.

Last updated

Was this helpful?