Skip to main content

TestMachine API (1.0.0)

Download OpenAPI specification:Download

API for accessing token data.

Health

Health check endpoints

Health Check

Returns gateway health status and optionally backend service health.

query Parameters
services
string
Enum: "true" "false"

Include backend service health checks

Responses

Response samples

Content type
application/json
{
  • "status": "healthy",
  • "timestamp": "2019-08-24T14:15:22Z",
  • "services": [
    ]
}

Tokens

Token information and behaviors

Create Token

Register a new token for monitoring and analysis.

Authorizations:
ApiKeyAuth
Request Body schema: application/json
address
required
string^(0x)?[a-fA-F0-9]{40}$
network_id
required
integer
name
string
symbol
string

Responses

Request samples

Content type
application/json
{
  • "address": "string",
  • "network_id": 0,
  • "name": "string",
  • "symbol": "string"
}

Response samples

Content type
application/json
{
  • "token_id": 0
}

Subscribe to Token

Subscribe to receive notifications for a token. The token must already exist.

Authorizations:
ApiKeyAuth
Request Body schema: application/json
address
required
string^(0x)?[a-fA-F0-9]{40}$
network_id
required
integer

Responses

Request samples

Content type
application/json
{
  • "address": "string",
  • "network_id": 0
}

Response samples

Content type
application/json
{
  • "error": "string",
  • "message": "string"
}

Get Token Details

Returns aggregated token details including behaviors, contract metadata, and market data.

Authorizations:
ApiKeyAuth
path Parameters
network
required
string

Network ID (e.g., 1 for Ethereum mainnet)

address
required
string

Token contract address

query Parameters
contract
string
Enum: "true" "false"

Include contract metadata (default: true)

price
string
Enum: "true" "false"

Include market/price data (default: true)

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "address": "string",
  • "network_id": 0,
  • "name": "string",
  • "symbol": "string",
  • "last_analyzed": "2019-08-24T14:15:22Z",
  • "behaviors": [
    ],
  • "contract": {
    },
  • "market": {
    }
}