Quickstart

Make your first payment request in under 5 minutes.

1. Get your API key

Sign up at the Direkt dashboard and copy your API key from Settings → API Keys.

2. Create a quote

curl -X POST http://159.223.110.114:3000/api/quote \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
		"fromChainId": 8453,
		"toChainId": 56,
		"fromToken": "0x0000000000000000000000000000000000000000",
		"toToken": "0x0000000000000000000000000000000000000000",
		"amount": "1",
		"recipient": "0xa110c77fa4b07ab601e63edEAd99ddb8f1df22c"
}'

curl --location 'https://godirekt.xyz/api/quote' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "fromChainId": 8453,
    "toChainId": 56,
    "fromToken": "0x0000000000000000000000000000000000000000",
    "toToken": "0x0000000000000000000000000000000000000000",
    "amount": "1",
    "recipient": "0xa110c77fa4b07ab601e63ecd65e99ddb8f1df6ec"
  }'

Response:

{
  "success": true,
  "quoteId": "5af8532c-5bf4-45c2-b099-1b36e96e91a3",
  "expiresIn": 300,
  "send": {
    "depositAddress": "0x7fa491b5765b5eea6b113a9121c311d780f8c61b",
    "chain": { "id": 8453, "name": "Base" },
    "token": { "symbol": "ETH", "name": "Ether", "decimals": 18 },
    "amount": "1"
  },
  "receive": {
    "chain": { "id": 56, "name": "BNB Chain" },
    "token": { "symbol": "BNB", "name": "Binance Coin", "decimals": 18 },
    "estimatedAmount": "3.119712602260738657",
    "estimatedAmountUsd": "1992.034702"
  },
  "fees": { "totalUsd": "13.4972" },
  "estimatedTime": "1s",
  "statusUrl": "/api/status/5af8532c-5bf4-45c2-b099-1b36e96e91a3",
  "depositNote": "Send exactly this amount to the deposit address. Execution begins automatically."
}

3. Show the address to your user

Show send.depositAddress, send.amount, send.token.symbol, and send.chain.name. The user sends from their wallet — no redirect needed.

4. Poll for status

Response:

{
    "success": true,
    "quoteId": "e8b287fe-14c6-4605-8bea-605400892c04",
    "status": "AWAITING_DEPOSIT",
    "createdAt": 1780008351,
    "expiresAt": 1780008651,
    "depositAddress": "0xa00f48aa41c72be710a41eda5a17ecde67905aee",
    "deposit": null,
    "gas": null,
    "execution": {
        "startedAt": null,
        "completedAt": null,
        "outputTxHash": null,
        "steps": []
    },
    "route": {
        "from": {
            "chainId": 8453,
            "chainName": "Base",
            "token": "0x0000000000000000000000000000000000000000"
        },
        "to": {
            "chainId": 56,
            "chainName": "BNB Chain",
            "token": "0x0000000000000000000000000000000000000000"
        },
        "amount": "1000000000000000000",
        "recipient": "0xa110c77fa4b07ab601e63ecd65e99ddb8f1df6ec"
    },
    "error": null
}

curl --location 'https://godirekt.xyz/api/status/5af8532c-5bf4-45c2-b099-1b36e96e91a3' \
  --header 'x-api-key: YOUR_API_KEY'

Poll every 5–10 seconds until status is COMPLETED.

Status	Meaning
AWAITING_DEPOSIT	Waiting for user to send
DEPOSIT_RECEIVED	Deposit detected
EXECUTING	Swap in progress
COMPLETED	Funds delivered — fulfil the order
EXPIRED	Timed out
FAILED	Execution failed

Next steps

Authentication

Learn how API keys work

Create a payment (guide)

Full integration walkthrough