List addresses
Newest first. `next_cursor` is returned only on a full page.
Authorization
KeyID Timestamp Nonce Signature X-Gyvar-Key<token>
Your key id, gyv_k_live_... or gyv_k_sandbox_....
In: header
X-Gyvar-Timestamp<token>
Unix seconds. Must be within 5 minutes of our clock.
In: header
X-Gyvar-Nonce<token>
A unique value per request. Replays are rejected.
In: header
X-Gyvar-Signature<token>
Ed25519 signature over the canonical string. See the Signing guide.
In: header
Query Parameters
chain?string
Filter to one chain.
Value in
- "bitcoin"
- "tron"
- "ethereum"
- "polygon"
- "solana"
- "base"
- "bsc"
reference?string
Filter to the addresses you tagged with this reference.
limit?integer
1-100, default 50. Larger values are treated as 100.
Range
1 <= value <= 100Default
50cursor?string
The next_cursor from the previous page. Treat it as opaque.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/addresses"{ "data": [ { "id": "0d6c2f3a-1b4e-4c9a-9f2d-7a1e5c8b3d60", "chain": "bitcoin", "address": "0x2f1a9C4b7E3d5A8f6B0c1D4e7A9b2C5d8E3f6A1b", "assets": [ "USDT", "USDC" ], "label": "Ama Owusu", "reference": "customer_8842", "created_at": "2019-08-24T14:15:22Z" } ], "next_cursor": "string"}