Merchant Setup

Submit a token or NFT to the public registry (pending review)

Submit a token or NFT collection to the public registry. X-API-Key required (free: no credits are charged; the key is only for accountability). A submission is held as pending until approved; some submissions are added at once (the response says which: pending, active). The submission is routed into one of two buckets by asset type: tokens (ERC-20 utility or ERC-3643 security, plus Solana SPL) and NFTs (ERC-721/1155, including ERC-5192 soulbound). Set assetType ("token"/"nft") explicitly, or it is inferred from standard (defaulting to NFT). A token submission requires symbol. Idempotent per chain + address: a re-submit of the same asset returns the existing entry rather than creating a duplicate. EVM addresses are normalized lowercase; Solana mint addresses are left as-is. Returns a flat envelope (no data wrapper). Rate limited (429).

post/v1/registry/submit

Request

  • Base URL: https://api.insumermodel.com
  • URL: https://api.insumermodel.com/v1/registry/submit
  • Auth: API key in header X-API-Key

Request body

namestring required
assetType'token' | 'nft'

Which registry to list the submission in. "token": the token registry (ERC-20, ERC-3643, SPL and similar); "nft": the NFT registry (ERC-721/1155/5192). If omitted, inferred from standard, defaulting to "nft". A "token" submission requires symbol. type is accepted as an alias for this field.

contractAddressstring

EVM contract address. Provide this or mintAddress.

mintAddressstring

Solana mint address. Provide this or contractAddress.

chainNamestring
symbolstring

Ticker symbol. Required for token submissions; ignored for NFTs.

decimalsinteger

Token decimals (token submissions only).

imagestring

Collection image URL (NFT submissions). For tokens, use logo.

logostring

Token logo URL (token submissions). image is accepted as a fallback.

standardstring

e.g. ERC-721, ERC-20, ERC-3643. Used to infer assetType when it is omitted.

websitestring
descriptionstring
coingeckoIdstring

CoinGecko id for market-cap lookup (token submissions only).

sourcestring

Provenance tag shown in the admin review queue (e.g. "partner-app").

Response

Already listed (idempotent)

oktrue
alreadyListedtrue
pendingboolean
activeboolean
docIdstring

Example response

{
  "meta": {
    "version": "1.0"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.