API Reference

Assets

The asset registry: which (code, issuer) pairs exist per network and who issues them. `verified` is a claim about the issuer’s identity, not about quality.

GET
/v1/assets

The wallet ships a bundled copy of this list and prefers whichever of the two carries the higher version, so a client that cannot reach this endpoint still resolves assets correctly. It just misses the newest additions.

Requires an API key, with no particular scope. The shared public key may call it.

apiKey
headerAuthorizationBearer <API key>

Your Cosmos Pay secret API key, sent as Authorization: Bearer <apiKey>.

network?string

Which Stellar network to list.

Default"public"
Value in"public""testnet"
verified?string

Return only issuer-verified entries. Omit to get the whole catalog, verified and not, and render the difference.

OK

The body, query or path failed validation. message is an array of the individual failures.

Routes that reject a valid request for a reason of their own (an amount, a memo, a state) document the code for it on their own 400.

no_authenticated_consumer: The gateway forwarded no API key identity

insufficient_scope: the API key does not hold the scope this route requires. The shared public API key also gets this on every route that is not marked x-cosmos-public-key, with a message saying so; more scopes will not help, the key is the wrong one.

gateway_required: the request did not arrive through APISIX.

Unexpected server error. The detail is logged server-side and never returned: there is nothing in the body to branch on beyond the code.

Example Request
curl -X GET 'https://api.cosmospay.lat/cosmos-api/v1/assets'
Example Response
{  "network": "public",  "version": 1,  "data": [    {      "code": "USDT0",      "issuer": "GATISXX6BZ6NC7IKQBY37CJD4SOZL3CYZJWXEDG6JVIY4WBS6KXJHN6Q",      "name": "USDT0",      "issuerName": "Tether",      "issuerDomain": "centre.io",      "verified": true,      "contract": "CBSJZEIO5C7KC2SF3MKSNXXJSW5G3VTNBX4ATMKUI3B2MR4JKM4R26YF",      "flags": {        "authRevocable": true,        "clawback": false      }    }  ]}