Tokens

Token information and behaviors

Create Token

post

Register a new token for monitoring and analysis.

Authorizations

ApiKeyAuth

X-API-KeystringRequired

API key for authentication

Body

application/json

addressstringRequiredPattern: ^(0x)?[a-fA-F0-9]{40}$

network_idintegerRequired

namestringOptional

symbolstringOptional

Responses

201

Token created successfully

application/json

400

Bad request - invalid address or network

application/json

401

Unauthorized - missing or invalid API key

application/json

403

Forbidden - insufficient permissions

application/json

409

Conflict - token already exists

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

post

/tokens

HTTPcURLJavaScriptPython

POST /v1/tokens HTTP/1.1
Host: api.testmachine.ai
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 63

{
  "address": "text",
  "network_id": 1,
  "name": "text",
  "symbol": "text"
}

{
  "token_id": 1
}

Subscribe to Token

post

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

Authorizations

ApiKeyAuth

X-API-KeystringRequired

API key for authentication

Body

application/json

addressstringRequiredPattern: ^(0x)?[a-fA-F0-9]{40}$

network_idintegerRequired

Responses

200

Subscribed successfully

No content

400

Bad request - invalid address or network

application/json

401

Unauthorized - missing or invalid API key

application/json

403

Forbidden - insufficient permissions

application/json

404

Token not found

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

post

/tokens/subscribe

HTTPcURLJavaScriptPython

POST /v1/tokens/subscribe HTTP/1.1
Host: api.testmachine.ai
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "address": "text",
  "network_id": 1
}

No content

Get Token Details

get

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

Authorizations

ApiKeyAuth

X-API-KeystringRequired

API key for authentication

Path parameters

networkstringRequired

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

addressstringRequired

Token contract address

Query parameters

contractstring · enumOptional

Include contract metadata (default: true)

Possible values:

pricestring · enumOptional

Include market/price data (default: true)

Possible values:

Responses

200

Token details

application/json

400

Bad request - invalid network or address

application/json

401

Unauthorized - missing or invalid API key

application/json

403

Forbidden - insufficient permissions

application/json

404

Token not found

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/tokens/{network}/{address}

HTTPcURLJavaScriptPython

GET /v1/tokens/{network}/{address} HTTP/1.1
Host: api.testmachine.ai
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "id": 1,
  "address": "text",
  "network_id": 1,
  "name": "text",
  "symbol": "text",
  "last_analyzed": "2026-02-14T22:54:53.904Z",
  "behaviors": [
    {
      "kind": "text",
      "function_signature": "text",
      "authority_address": "text",
      "last_observed_at": "2026-02-14T22:54:53.904Z"
    }
  ],
  "contract": {
    "is_verified": true,
    "deployer": "text",
    "contract_name": "text"
  },
  "market": {
    "price_usd": 1,
    "price_change_24h": 1,
    "volume_24h_usd": 1,
    "market_cap_usd": 1
  }
}