API Reference
GuidesReleasesPostmanRecipesAPI Reference

Register a token

post
https://sandbox.notabene.id/api/v1/tokens

Adds a token contract to your registry so it can be referenced by transfers and payments.

Required permission: update:vasp.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Used in these guides:

Body Params
string
required

Contract address of the token, with no chain prefix. For a native coin, slip44: and the coin type, as in slip44:60.

string
required

CAIP-19 identifier of the token. A testnet’s native coin uses coin type 1, as in eip155:11155111/slip44:1. Identifiers are compared exactly, so the same address in another case makes a second token.

string
required

CAIP-2 identifier of the chain the token is deployed on.

int64
required

The blockchain’s numeric ID, such as 1 for Ethereum or 11155111 for Sepolia. It is 0 for blockchains such as Bitcoin.

int64
required

Number of decimal places the token uses.

string
required

Display name of the token.

string
required

Trading symbol of the token.

string

The id of the asset this token represents, a UUID from the answer of POST /api/v1/assets. Without it, the token shows in the dashboard only under its blockchain.

string

ISO 4217 code of the fiat currency this tracks.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

429

Too Many Requests: more than 6,000 calls in 300 seconds. Every endpoint refuses your calls for the next 10 seconds. Send the request again with a backoff, as Rate limiting explains.

Updated 20 days ago

Did this page help you?
Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json

Updated 20 days ago

Did this page help you?