Tereno Token Metadata · Token Metadata Invoke

by Tereno Token Metadata

GETBase

$0.03

per call · USD Coin on Base

What token is this? Read a Base token's name, symbol, decimals and total supply in one cheap typed call, with block-level freshness and explicit limitations. Identity is shared across agents for 7 days while total supply is re-read on every call beyond the block window the answer was quoted for. Positive-sum by design: $0.03 cold, $0.02 when the token identity is already shared, $0.01 on a shared full answer — and the wallet that seeded it earns a share of every reuse.

Endpoint

GET https://www.tereno.xyz/api/v1/capabilities/token.metadata/invoke

9

Calls / 30d

4

Unique payers / 30d

Sep 9

Last called

exact

Payment scheme

Call this service

TypeScript · @x402/fetch
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://www.tereno.xyz/api/v1/capabilities/token.metadata/invoke", {
  method: "GET",
});
const data = await res.json();
cURL
curl -X GET \
  "https://www.tereno.xyz/api/v1/capabilities/token.metadata/invoke?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" \
  -H "X-PAYMENT: <signed x402 payment>"

Example response

{
  "capabilityId": "token.metadata",
  "capabilityVersion": "1.0.0",
  "invocationId": "uuid",
  "pricing": {
    "actualCacheStatus": "miss",
    "creditAppliedUsd": 0,
    "currency": "USDC",
    "listPriceUsd": 0.001,
    "pricePaidUsd": 0.001,
    "quotedCacheStatus": "miss"
  },
  "receiptUrl": "/api/v1/receipts/uuid",
  "result": {
    "computedAtBlock": 123456,
    "erc20Readable": true,
    "reasonCodes": [
      "ERC20_METADATA_READ"
    ],
    "token": {
      "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "decimals": 6,
      "name": "USD Coin",
      "symbol": "USDC",
      "totalSupply": "3500000000000000"
    },
    "validUntilBlock": 123461,
    "verdict": "allow"
  },
  "verdict": "allow"
}

Payment details

Pay to0xfbf218accbb0d57fc4e8fc3e2a885c910c4c9e94
AssetUSD Coin · 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
NetworksBase
Schemesexact

Is this your API?

Pin it to the top of Onchain Data and the homepage with a featured placement.

Get featured →

More from Tereno Token Metadata & similar services