Key and coins

Test a connection and list the coins you can take right now.

Updated 2 November 2026Live from Tocler

GET /api/pay/v1/me Your Tocler Pay merchant key

The key and its merchant — use it to test a connection.

Errors

401 unauthorized — No key, a wrong key, or a revoked / expired key (key_revoked, key_expired).
403 ip_not_allowed — The call came from an address the key does not allow.
429 rate_limited — Too many requests — slow down and try again.

curl -X GET 'https://api.tocler.com/api/pay/v1/me' \
  -H 'Authorization: Bearer tp_live_…'

{
  "object": "api_key",
  "key_id": "Ab3dEf6hJk9m",
  "name": "Shop server",
  "scopes": [
    "payments:create",
    "payments:read"
  ],
  "address_modes": [
    "own"
  ],
  "coins": [],
  "max_usd_per_payment": "500.00",
  "daily_usd_limit": null,
  "rate_per_minute": 120,
  "expires_at": null,
  "merchant": {
    "id": "mch_XXXXXXXXXXXXXX",
    "name": "My shop"
  }
}

GET /api/pay/v1/coins Your Tocler Pay merchant keypayments:read

Coins you can take right now: switched on, with a ready address for that owner, allowed for the key.

address_modestringquery
tocler or own — needed when the key has both.
payeestringquery
Own mode: a sub-account of yours (e.g. a seller id).

Errors

400 invalid_request — A field is missing or wrong — see error.field.
401 unauthorized — No key, a wrong key, or a revoked / expired key (key_revoked, key_expired).
403 missing_scope — The key lacks the scope this call needs.

curl -X GET 'https://api.tocler.com/api/pay/v1/coins' \
  -H 'Authorization: Bearer tp_live_…'

{
  "object": "list",
  "address_mode": "own",
  "data": [
    {
      "key": "usdt_tron",
      "symbol": "USDT",
      "name": "Tether USD (TRC-20)",
      "network": "tron",
      "network_name": "TRON",
      "stable": true
    }
  ]
}

Was this page helpful?