Account's Coin Holdings

Retrieve the information about coin holdings of a specific address, including amounts, USD values, PnL, and price changes.

---

Endpoint

GET /api/v1/partner/portfolio/coins

---

Request Parameters

Name	Type	Required	Description
address	string	Yes	The address to retrieve coin holdings for.

---

Headers

Header	Required	Description
x-api-key	No	API key for authorization.

---

cURL Example

curl --location 'https://api.noodles.fi/api/v1/partner/portfolio/coins?address=0xe9008ec0faa85024b357ebb7aa80cfc081ecf5a77bca299e5b365c627f1bb466' \
--header 'x-api-key: YOUR_API_KEY'

---

Response

Fields

Field	Type	Nullable	Description
code	number	No	HTTP status code (200 for success).
message	string	No	Status message.
data	array	No	Array of coin holding objects.

Coin Holding Object

Field	Type	Nullable	Description
coin_type	string	No	Coin type identifier.
symbol	string	No	Coin symbol.
decimals	number	No	Number of decimal places for the coin.
icon_url	string	Yes	URL to the coin icon.
amount	float	No	Amount of the coin held.
usd_value	float	No	USD value of the coin holdings.
verified	boolean	No	Whether the coin is verified.
price	float	No	Current price of the coin.
pnl_today	float	Yes	Profit/Loss for today.
pnl_percent_today	float	Yes	Profit/Loss percentage for today.
price_change_1d	float	Yes	Price change over 1 day (percentage).
price_change_7d	float	Yes	Price change over 7 days (percentage).
price_change_30d	float	Yes	Price change over 30 days (percentage).

Success Response

{
    "code": 200,
    "message": "OK",
    "data": [
        {
            "coin_type": "0xbde4ba4c2e274a60ce15c1cfff9e5c42e41654ac8b6d906a57efa4bd3c29f47d::hasui::HASUI",
            "symbol": "haSUI",
            "decimals": 9,
            "icon_url": "https://imagedelivery.net/cBNDGgkrsEA-b_ixIp9SkQ/hasui.svg/public",
            "amount": 9.353067787,
            "usd_value": 37.67,
            "verified": true,
            "price": 4.027,
            "pnl_today": -2.09,
            "pnl_percent_today": -5.25,
            "price_change_1d": -2.83,
            "price_change_7d": -5.1,
            "price_change_30d": 34.39
        }
    ]
}

---

See also: Environment Setup