API reference
List receiving addresses
Returns up to 200 addresses scoped to the calling org + environment.
GET
/v1/addressesAuthorization
bearerAuth AuthorizationBearer <token>
Paste your API key from the dashboard (no sk_ prefix required).
In: header
Query Parameters
status?string
Filter by allocation status.
chain?string
Filter by chain.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/addresses"{
"items": [
{
"id": "string",
"chain": "ethereum",
"address": "string",
"label": "string",
"mode": "single",
"status": "available",
"created_at": "2019-08-24T14:15:22Z"
}
]
}{
"statusCode": -9007199254740991,
"message": "string",
"error": "string"
}{
"statusCode": -9007199254740991,
"message": "string",
"error": "string"
}Import receiving addresses POST
Bulk-imports merchant addresses for one or more chains. Existing (chain, address) rows are skipped, normalization is applied before storage.
Update an address PATCH
Toggle label / mode / status. Addresses currently allocated to an open order cannot be re-statused manually.