Bulfinex

API Documentation

Bulfinex API v1 — deploy tokens programmatically across 100+ blockchains. All endpoints return JSON with consistent response format.

Quick Start

1. Get your API key:

POST /api/v1/account/keys {"name": "my-app", "mode": "test"}

2. List supported chains:

curl https://bulfinex.com/api/v1/chains \
  -H "X-API-Key: bfx_test_xxxxx"

3. Deploy a token:

curl -X POST https://bulfinex.com/api/v1/tokens \
  -H "X-API-Key: bfx_test_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "chainId": "polygon",
    "name": "My Token",
    "symbol": "MTK",
    "totalSupply": "1000000",
    "owner": "0x1234...5678"
  }'

Authentication

Include your API key in the X-API-Key header:

X-API-Key: bfx_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Free

10 req/min

Basic

60 req/min

Pro

300 req/min

Enterprise

Custom

Response Format

{
  "success": true,
  "data": { ... },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-03-24T12:00:00Z"
  }
}

Endpoints

Authentication

All API requests require an X-API-Key header.

GET/v1/account
GET/v1/account/usage
GET/v1/account/keys
POST/v1/account/keys
DELETE/v1/account/keys/:id

Tokens

Create, validate, and manage tokens.

POST/v1/tokens
GET/v1/tokens
GET/v1/tokens/:id
GET/v1/tokens/:id/status
POST/v1/tokens/validate
POST/v1/tokens/estimate

Chains

List and query supported blockchains. No auth required.

GET/v1/chains
GET/v1/chains/:id
GET/v1/chains/:id/gas
GET/v1/chains/:id/status

Payments

Cost estimation and payment tracking.

POST/v1/payments/estimate
POST/v1/payments
GET/v1/payments/history
GET/v1/payments/:id

Webhooks

Receive real-time notifications for deployment events.

POST/v1/webhooks
GET/v1/webhooks
DELETE/v1/webhooks/:id

Enterprise

Enterprise token operations for Industry 4.0.

POST/v1/enterprise/tokens
GET/v1/enterprise/tokens
GET/v1/enterprise/supply-chain/:id
GET/v1/enterprise/qa/verify/:id

System

Platform status and health.

GET/v1/health

JavaScript SDK

import { Bulfinex } from '@bulfinex/sdk';

const client = new Bulfinex('bfx_test_xxxxx');

// List chains
const chains = await client.chains.list();

// Deploy a token
const token = await client.tokens.deploy({
  chain: 'polygon',
  name: 'My Token',
  symbol: 'MTK',
  totalSupply: '1000000',
  owner: '0x1234...',
  features: { mintable: true, burnable: true },
});

// Check status
const status = await client.tokens.getStatus(token.id);

Error Codes

MISSING_API_KEYX-API-Key header not provided
INVALID_API_KEYKey format invalid or revoked
RATE_LIMITEDToo many requests
VALIDATION_ERRORInput validation failed
INVALID_CHAINChain not found or not supported
INVALID_ADDRESSWallet address format invalid
SUPPLY_OVERFLOWSupply exceeds max uint256
AUTH_REQUIREDAuthentication required
NOT_FOUNDResource not found
INTERNAL_ERRORUnexpected server error