Home screen
curl --request GET \
--url https://api.matocard.xyz/me \
--header 'Authorization: <api-key>'import requests
url = "https://api.matocard.xyz/me"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.matocard.xyz/me', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.matocard.xyz/me",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.matocard.xyz/me"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.matocard.xyz/me")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.matocard.xyz/me")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"user": {
"wallet": "0xC0519BE562f0De7E32e9A48e50AdecBAde605aAD",
"kyc": "none",
"country": "<string>"
},
"card": {
"number": "9988301477215569"
},
"verified": true,
"score": "1000000",
"ratioBps": "1000000",
"limit": "1000000",
"available": "1000000",
"drawn": "1000000",
"dueAt": "1000000",
"defaulted": true,
"cycles": {
"counted": "1000000",
"repaid": "1000000"
},
"collateral": {
"value": "1000000",
"yield": "1000000",
"pendingShares": "1000000",
"pendingUntil": "<string>"
},
"balance": "1000000"
}{
"error": "verify your identity first"
}Account
Home screen
GET
/
me
Home screen
curl --request GET \
--url https://api.matocard.xyz/me \
--header 'Authorization: <api-key>'import requests
url = "https://api.matocard.xyz/me"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.matocard.xyz/me', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.matocard.xyz/me",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.matocard.xyz/me"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.matocard.xyz/me")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.matocard.xyz/me")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"user": {
"wallet": "0xC0519BE562f0De7E32e9A48e50AdecBAde605aAD",
"kyc": "none",
"country": "<string>"
},
"card": {
"number": "9988301477215569"
},
"verified": true,
"score": "1000000",
"ratioBps": "1000000",
"limit": "1000000",
"available": "1000000",
"drawn": "1000000",
"dueAt": "1000000",
"defaulted": true,
"cycles": {
"counted": "1000000",
"repaid": "1000000"
},
"collateral": {
"value": "1000000",
"yield": "1000000",
"pendingShares": "1000000",
"pendingUntil": "<string>"
},
"balance": "1000000"
}{
"error": "verify your identity first"
}Authorizations
Matocard <wallet>.<until>.<signature>, see the description at the top
Response
The account
The home screen, read from the contract
Show child attributes
Show child attributes
For the card on the home screen. Visual only: no card network or issuer behind it
Show child attributes
Show child attributes
Verified onchain; can top up and draw
0–100
Pattern:
^[0-9]+$Example:
"1000000"
Collateral needed per unit of limit, in basis points: 15000 (150%) at score 0 down to 8000 at 100
Pattern:
^[0-9]+$Example:
"1000000"
AUSD the collateral allows
Pattern:
^[0-9]+$Example:
"1000000"
AUSD that can still be drawn
Pattern:
^[0-9]+$Example:
"1000000"
AUSD owed
Pattern:
^[0-9]+$Example:
"1000000"
Unix time the debt is due, 0 when nothing is owed
Pattern:
^[0-9]+$Example:
"1000000"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
AUSD in the wallet (drawn or received), outside the credit line
Pattern:
^[0-9]+$Example:
"1000000"

