Successful Transactions

Get a list of all successful transactions - don't hesitate to reach out for additional support at [email protected]

Endpoint

GET https://api.bindpay.xyz/v1/successful-transactions

Headers

Header	Value	Description
Content-Type	application/json	The content type of the request
x-api-key	Your API key	Your unique API key for authentication

Query Parameters

None required. The API will return all successful transactions associated with your API key.

Notes

• Returns all completed transactions for your business or specific subpayee

• Transactions are sorted by creation date (newest first)

• Results include both direct transfers and cross-chain swaps

• For subpayee API keys, only transactions related to that specific subpayee are returned

Example Request

curl -X GET "https://api.bindpay.xyz/v1/successful-transactions" \
     -H "Content-Type: application/json" \
     -H "x-api-key: your_api_key_here"

Response

The API will respond with a JSON array containing the transaction details.

Successful Response

[
  {
    "id": "6729a49048ad67c3a3611163",
    "fromChain": "1",
    "toChain": "137",
    "fromToken": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "toToken": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
    "fromAmount": "100000000",
    "toAmount": "99750000",
    "usdAmount": 100,
    "fromAddress": "0x742d35Cc6634C0532925a3b844Bc45426438f000",
    "toAddress": "0x123d35Cc6634C0532925a3b844Bc45426438f789",
    "type": "Provider",
    "fee": "250000",
    "createdAt": "2024-03-19T10:30:00.000Z",
    "sourceTransactionHash": "0x123...",
    "destinationTransactionHash": "0x456...",
    "sourceAmount": "100000000",
    "destinationAmount": "99750000"
  }
  // ... additional transactions
]

Response Fields

Field	Type	Description
id	string	Unique transaction identifier
fromChain	string	Source blockchain chain ID
toChain	string	Destination blockchain chain ID
fromToken	string	Source token address
toToken	string	Destination token address
fromAmount	string	Original amount in token decimals
toAmount	string	Received amount in token decimals
usdAmount	number	Transaction value in USD
fromAddress	string	Source wallet address
toAddress	string	Destination wallet address
type	string	Transaction type (Quote Provider)
fee	string	Fee amount in token decimals
createdAt	string	Transaction creation timestamp
sourceTransactionHash	string	Hash of the source transaction
destinationTransactionHash	string	Hash of the destination transaction
sourceAmount	string	Actual sent amount
destinationAmount	string	Actual received amount

Status Codes

Status Code	Error Type	Description
200	Success	Request successful
400	Bad Request	API key is missing
404	Not Found	Business not found
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Server error

Error Handling

• Missing API key will return a 400 error

• Invalid API key will return a 404 error

• Rate limit exceeded will return a 429 error

• Server errors will return a 500 error with details

For more information on error handling and response codes, please get in contact with [email protected].