Get Account Info

Endpoint


GET https://api.tachyon.rath.fi/api/user

Query Parameters

Parameter	Type	Required	Description
`address`	string	Yes	The wallet address to retrieve account information for

Response

Success Response

chains-response.json


{
  "success": true,
  "data": {
    "userId": "usr_123456789",
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "availableBalance": 1000.50,
    "pendingBalance": 50.25,
    "defaultTachyonAccount": {
      "address": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "token": {
        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6,
        "iconUrl": "https://example.com/usdc-icon.png"
      },
      "chainId": 1
    }
  },
  "timestamp": "2025-10-24T12:34:56.789Z"
}

Response Fields

AccountInfo Object

Field	Type	Description
`userId`	string	Unique identifier for the user
`address`	string	The wallet address of the account
`availableBalance`	number	The current available balance in the account
`pendingBalance`	number	The balance that is currently pending
`defaultTachyonAccount`	object	Default Tachyon account configuration

defaultTachyonAccount Object

Field	Type	Description
`address`	string	The default account address
`token`	object	Token information for the default account
`chainId`	number	The blockchain network chain ID

token Object

Field	Type	Description
`address`	string	The token contract address
`symbol`	string	The token symbol (e.g., “USDC”, “ETH”)
`name`	string	The full name of the token
`decimals`	number	Number of decimal places for the token
`iconUrl`	string	URL to the token’s icon image

Error Response

error-response.json


{
  "success": false,
  "error": {
    "code": "INVALID_ADDRESS",
    "message": "The provided address is invalid",
    "category": "VALIDATION_ERROR",
    "details": {
      "field": "address",
      "message": "Address must be a valid Ethereum address"
    },
    "traceId": "trace_abc123xyz789"
  },
  "timestamp": "2025-10-24T12:34:56.789Z"
}

TachyonError Object

Field	Type	Description
`code`	string	Error code identifier
`message`	string	Human-readable error message
`category`	string	Error category classification
`details`	object	Additional error details (optional)
`traceId`	string	Unique trace identifier for debugging purposes

Error Details Object (Optional)

Field	Type	Description
`field`	string	The field that caused the error
`message`	string	Detailed error message
`validationErrors`	array	Array of validation error objects

Example Usage

cURL

api-request.sh


curl "https://api.tachyon.rath.fi/api/user?address=0x1234567890abcdef1234567890abcdef12345678"

Status Codes

Status Code	Description
200	Success - Account information retrieved
400	Bad Request - Invalid address format
404	Not Found - Account not found
500	Internal Server Error