Docs/Public API/Tokens API

Tokens API

Read loyalty programs indexed from public Loyfin events.

GET /tokens#

List indexed loyalty programs.

List programsbash

curl "https://api.loyfin.com/tokens?issuer=0x1111111111111111111111111111111111111111&limit=25"

Filters: cursor, limit, chainId, issuer, loyaltyId, q.

GET /tokens/:id#

Read programbash

curl https://api.loyfin.com/tokens/7

Object#

LoyaltyTokenjson

{
  "id": "7",
  "chainId": "8453",
  "loyaltyAddress": "0x4444444444444444444444444444444444444444",
  "issuer": "0x1111111111111111111111111111111111111111",
  "owner": "0x1111111111111111111111111111111111111111",
  "loyaltyId": "0x4242424242424242424242424242424242424242424242424242424242424242",
  "name": "Bloom Coffee Rewards",
  "symbol": "BLOOM",
  "media": "ipfs://bafy.../bloom.png",
  "description": "Rewards for Bloom Coffee customers.",
  "contractURI": "",
  "tokenURI": "",
  "royaltyBps": 200,
  "issuable": true,
  "redeemable": true,
  "transferable": true,
  "createdAt": "2026-06-20T10:15:00.000Z"
}