Get Token

GET /api/v1/tokens/:id

Overview

Retrieves the details of a specific cryptocurrency token using its unique identifier.

Authorization

Header: Authorization: Bearer $PAYBYTOKEN_SECRET_KEY

Request Details

Request

curl https://api-prod.paybytoken.io/api/v1/tokens/tok_ofIgtXhdeH7wWHIW \
  -X GET \
  -H "Authorization: Bearer $PAYBYTOKEN_SECRET_KEY"

Request Parameters

Parameter	Type	Description
`id`	string	Unique identifier of the token (e.g., `tok_ofIgtXhdeH7wWHIW`).

Response Details

Response

The response returns a Token object containing the details of the specified token. See Tokens Overview for the full object definition.

Example Response

{
  "id": "tok_ofIgtXhdeH7wWHIW",
  "currency": "USDC",
  "chain": "ethereum",
  "decimals": 6,
  "name": "USD Coin",
  "chain_id": 11155111,
  "chain_name": "Ethereum",
  "currency_logo_url": "https://paybytoken.oss-cn-hongkong.aliyuncs.com/token/usdc-logo.png",
  "chain_logo_url": "https://paybytoken.oss-cn-hongkong.aliyuncs.com/token/eth-logo.png",
  "chain_explorer_url": "https://sepolia.etherscan.io",
  "contract_address": "0x1C0c0a3843f952DcD9159C9101f8E74844d92fED",
  "minimum_payment": "1.0",
  "minimum_payout": "1.0",
  "maximum_payment": "50000.0",
  "maximum_payout": "1000000.0",
  "enabled": 1,
  "created_at": "2025-09-25T17:13:50.000Z",
  "updated_at": "2025-09-25T17:13:50.000Z"
}